← Back to Skills Marketplace
SmartThings Direct
by
Hankyeol Kyung
· GitHub ↗
· v0.1.0
· MIT-0
133
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install smartthings-direct
Description
Direct SmartThings hub control via the official SmartThings CLI. List devices, read device status, and execute capability commands without going through Home...
Usage Guidance
This skill looks coherent and uses the official SmartThings CLI. Before installing, ensure: (1) you have the smartthings CLI installed and trust the runtime that will execute it; (2) the agent will need authenticated access — prefer browser OAuth (the CLI opens a browser and stores a refresh token) over pasting a PAT; (3) if you must use a PAT, be aware it grants broad read/write/execute control over your devices and scenes and may be short-lived (the doc notes 24-hour expiry for newer PATs); (4) check where the CLI stores its config (~/.config/@smartthings/cli or ~/Library/Preferences/...), because storing a token there gives whoever can run the CLI full control; (5) the provided st-find.sh script is simple and only queries devices via the CLI and jq. If you are uncomfortable giving the agent account-level control, do not provide a PAT or global credentials — instead use interactive browser login or limit how the agent can invoke the skill.
Capability Analysis
Type: OpenClaw Skill
Name: smartthings-direct
Version: 0.1.0
The skill bundle provides a legitimate interface for the official SmartThings CLI to manage smart home devices. The included script 'scripts/st-find.sh' is a utility for device discovery that uses 'jq' for safe parsing and does not exhibit signs of command injection, data exfiltration, or malicious intent. All instructions in 'SKILL.md' are consistent with the tool's stated purpose of home automation.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: the skill invokes the official SmartThings CLI to list devices, read status, and send capability commands. The required binary (smartthings) is exactly what is needed and nothing unrelated is requested.
Instruction Scope
The SKILL.md and the included script only instruct the agent to run smartthings CLI commands and jq, plus suggest where the CLI stores its config. There is no attempt to read unrelated system files or exfiltrate data to external endpoints. The docs do instruct how to place a PAT in the CLI config file (a sensitive action), which is expected for this kind of integration.
Install Mechanism
No install spec is included (instruction-only), and the doc recommends installing via Homebrew or npm — both are standard, low-risk sources for this CLI. No arbitrary download URLs or archive extraction are present.
Credentials
The skill declares no required env vars and does not request unrelated credentials. However, to operate it needs authenticated SmartThings access (browser OAuth or a Personal Access Token). PAT scopes listed (read/write/execute for devices and scenes) are broad but necessary for device control; treat PATs as highly sensitive. The SKILL.md notes config file paths where a token could be stored, which is expected but important to be aware of.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges. The CLI itself will store tokens in its own config if you choose PAT or browser refresh tokens, which is normal for the CLI but outside the skill's direct behavior.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install smartthings-direct - After installation, invoke the skill by name or use
/smartthings-direct - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: direct SmartThings CLI skill for device listing, status, and commands
Metadata
Frequently Asked Questions
What is SmartThings Direct?
Direct SmartThings hub control via the official SmartThings CLI. List devices, read device status, and execute capability commands without going through Home... It is an AI Agent Skill for Claude Code / OpenClaw, with 133 downloads so far.
How do I install SmartThings Direct?
Run "/install smartthings-direct" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is SmartThings Direct free?
Yes, SmartThings Direct is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does SmartThings Direct support?
SmartThings Direct is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created SmartThings Direct?
It is built and maintained by Hankyeol Kyung (@keenranger); the current version is v0.1.0.
More Skills