smartthings
Read status and send commands to Samsung SmartThings devices: lights, locks, thermostats, sirens, garage doors. Trigger phrases: smartthings, samsung smart home, unlock the door, smartthings thermostat.
- License 许可
- MIT
- 最近更新
- 2026-11-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- smartthings
- tagline
- Read device status and issue capability commands across a Samsung SmartThings account: locations, devices, switches, dimmers, locks, thermostats, sirens, garage door controllers, and window shades. Use it when the user asks about or wants to change the state of anything paired to their SmartThings hub or cloud account. This connector drives real physical hardware, so every write is confirmation-gated (see Operating Rules).
- metadata
- { "includeInPrompt": true }
- description
- Read status and send commands to Samsung SmartThings devices: lights, locks, thermostats, sirens, garage doors. Trigger phrases: smartthings, samsung smart home, unlock the door, smartthings thermostat.
- catalog_auth
- provider OAuth 2.0 via the secure credential flow
- catalog_hosts
- [ "api.smartthings.com" ]
02 资源文件 1
- 脚本bin/smartthings.py10.0 KB
03 SKILL.md 正文
SmartThings
Purpose
Read device status and issue capability commands across a Samsung SmartThings account: locations, devices, switches, dimmers, locks, thermostats, sirens, garage door controllers, and window shades. Use it when the user asks about or wants to change the state of anything paired to their SmartThings hub or cloud account. This connector drives real physical hardware, so every write is confirmation-gated (see Operating Rules).
Tooling
All commands go through bin/smartthings.py:
bin/smartthings.py auth # status check: verify token, list locations
bin/smartthings.py locations # list locations
bin/smartthings.py devices --limit 50 # list devices with capabilities
bin/smartthings.py status --id <deviceId> # read full device status
# Writes. HIGH actuations (lock unlock, garage open/close) REQUIRE
# --confirm naming the exact physical effect, on every run:
bin/smartthings.py command --id <deviceId> --capability lock --command unlock \
--confirm "unlock front door deadbolt"
bin/smartthings.py command --id <deviceId> --capability garageDoorControl --command open \
--confirm "open the garage door"
# MEDIUM actuations (switches, dimmers, thermostats, sirens) need --confirm on
# first use per device; later runs proceed without it:
bin/smartthings.py command --id <deviceId> --capability switch --command on \
--confirm "turn on the living room lamp"
bin/smartthings.py command --id <deviceId> --capability switchLevel --command setLevel \
--arg 50 --confirm "dim bedroom light to 50 percent"
bin/smartthings.py command --id <deviceId> --capability thermostatMode \
--command setThermostatMode --arg '"heat"' --confirm "set hallway thermostat to heat"
bin/smartthings.py command --id <deviceId> --capability alarm --command both \
--confirm "sound the hallway siren"
# LOW actuations (window shades / curtains) proceed with a logged notice:
bin/smartthings.py command --id <deviceId> --capability windowShadeLevel \
--command setShadeLevel --arg 100
--arg values are JSON-parsed, so pass numbers bare (--arg 50) and strings
as quoted JSON (--arg '"heat"') or plain text (falls back to a string).
--component defaults to main; set it when the device exposes other
components.
Auth
- Provider id:
smartthings(credential is collected ascustom.smartthings) - Collection: OAuth 2.0 authorization-code flow via the secure credential flow
(
credentials.request_api_access). Set up: create an app at developer.smartthings.com with the scopes the user needs (devices read, device commands), complete the authorization-code grant, and store the resulting access token. Personal Access Tokens now expire after about 24 hours, so a persistent connector must use the OAuth flow. - Required scopes:
r:devices:*at minimum for reads; addx:devices:*(commands) only for the devices the user wants Muse to actuate. - Allowed hosts:
api.smartthings.com - Status check:
bin/smartthings.py auth
Operating Rules
- HIGH actuations are blocked without explicit confirmation. Unlocking a
lock and opening or closing a garage door require
--confirm "<exact physical effect>"on every single run, e.g.--confirm "unlock front door deadbolt". A bare--confirmor a vague value is rejected by the CLI. Never pre-fill the confirmation on the user's behalf: the exact effect must come from the user's own words. - MEDIUM actuations confirm on first use per device. Switches, dimmers,
thermostat modes and setpoints, and siren on/off need
--confirmthe first time a device is actuated; the CLI records that confirmation locally (~/.config/muse-connectors/smartthings/confirmed.json) and later runs proceed. A thermostat change starts or stops real heating/cooling; treat every MEDIUM run as if the user is watching. - LOW actuations (window shades, curtains) proceed with a notice printed to stderr. No confirmation needed.
- Never lock someone out or in. Do not lock a door unless the user explicitly asked for that lock to be locked; locking is a write and follows the same grading as unlock (MEDIUM, first-use confirmed) but verify intent twice in conversation first.
- Read commands (
auth,locations,devices,status) never need confirmation. - Rate limit: roughly 120 requests/min on the commands endpoint per device/principal. Space out bulk actuations.
- Cost warning: Samsung announced paid SmartThings tiers starting October 2026 (about $4.99/month for the personal tier). Heavy or always-on use may fall under a paid tier.
- Zigbee/Z-Wave devices need a SmartThings hub online; cloud-only devices work without one.
- Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.
Files
- SKILL.md
- bin/smartthings.py
Maturity
🧪 Draft: written from SmartThings' public REST API docs; not yet live-tested
end-to-end. The command request shape (component, capability, command,
arguments) and the --arg JSON parsing are untested against a real device.
04 同仓库更多 Skills
web-scrape
Turn web pages into LLM-ready markdown via the Firecrawl API (renders JS, anti-bot handling). Use when browser_open/fetch fails on JS-heavy pages, or when you need clean markdown/structured extraction from a site. Requires FIRECRAWL_API_KEY.
design-taste-frontend
tasteskill v2, the anti-slop frontend skill. Art direction for websites, distilled from a study of 247 curated gallery sites (One Page Love, Awwwards Sites of the Day). Deals researched directions (idea, composition, type, palette, photographs, section blueprints) from a library, enforces a strict no-slop house style with a real-browser inspector, and runs a look-and-fix loop on screenshots. Use this whenever you build, design, redesign, restyle, polish or review a landing page, marketing site, portfolio, product page, one-pager, hero or any public-facing web page, in any stack (HTML/CSS, React, Next.js, Vue, Svelte, Astro, Tailwind) — also when the user says a page looks generic, templated, "AI-made", sloppy, or asks to make it look designed, premium, award-level or less like every other site. Not for dashboards or app screens.
test-driven-development
Use when implementing any feature or bugfix, before writing implementation code
systematic-debugging
Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
requesting-code-review
Use when completing tasks, implementing major features, or before merging to verify work meets requirements
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).