📢 Notice Features, documentation, and skill behaviors may change. Your feedback via GitHub Issues is highly appreciated!
A collection of AI-powered skills that accelerates SmartThings device integration. It supports the full lifecycle, from initial code generation to WWST certification.
This project provides SmartThings Developer AI Skills for developers who want to integrate devices into the SmartThings ecosystem. Each skill improves development productivity with step-by-step guidance, best practices, code generation, and debugging support.
SmartThings supports three integration types depending on the device characteristics and the manufacturer's infrastructure:
| Integration Type | Description | Best For |
|---|---|---|
| Cloud Connected | A Device Integration in which devices communicate to the SmartThings cloud via your own cloud | Your devices connect to SmartThings through your own cloud backend |
| Hub Connected | A Device Integration in which devices connect to SmartThings via a SmartThings hub using Matter, Zigbee, or Z-Wave | Your devices integrate into the ecosystem through a SmartThings Hub |
| Direct Connected | A Device Integration in which devices communicate directly to the SmartThings cloud via MQTT / SmartThings SDK | Your IP devices connect to SmartThings without a separate cloud backend |
- SmartThings Developer account (Sign up)
- SmartThings CLI (optional, recommended)
- An AI Assistant with file system manipulation capabilities (e.g., Claude Code, Cursor)
SmartThings Developer AI Skills can be used with AI assistants that support file system operations and custom skill loading.
-
Installation Install the full SmartThings Developer AI Skills directory under
skills/to your AI Assistant's skill directory.You can instruct your AI assistant to install the skills directly by pasting the following prompt:
Install Agent Skills from https://github.com/SmartThingsCommunity/wwst-skills.💡 Installation Tip: If your AI Assistant does not support automatic skill installation, refer to your AI Assistant's documentation for manual skill installation instructions, or add the
skills/directory to your skill configuration path.Uninstall
- Delete the copied skill directory, or remove the reference from your tool's configuration.
-
Invoking a skill
When you ask in natural language, the AI assistant can automatically activate the appropriate skill:
- Cloud Connected (With API Spec)
Help me build a SmartThings Cloud Connected device integration. I have my own REST API specification ready in cloud_spec.md. - Hub Connected (With Device Spec Details)
I want to integrate this Zigbee device with SmartThings. It uses a Zigbee endpoint with Basic, Identify, On/Off, Level Control, and Electrical Measurement clusters. - Direct Connected / MQTT (With Product URL)
How can I integrate my smart fan into SmartThings using MQTT? It has speed control, oscillation, and a timer. Here is the product description page URL: https://example.com/product
- Cloud Connected (With API Spec)
This English README currently documents the following SmartThings Developer AI Skills under skills/.
Skill:
smartthings-cloud-connected-developer
This skill guides developers through the entire lifecycle of creating a SmartThings Cloud Connected (Schema App) integration, from organization setup to code generation, registration, and final WWST certification.
Key features
- Step-by-step progression from org setup through certification (5-step workflow)
- Device Profiles and Capabilities mapping
- Schema App code generation
- OAuth configuration, hosting, and Schema App registration guidance
- Debugging support for common integration issues (OAuth, discovery, state sync)
Best fit
- Teams with an existing cloud backend who want Cloud Connected integration
- Developers building a Schema App using Node.js
- Teams preparing WWST certification for Cloud Connected devices
Skill:
smartthings-hub-connected-developer
This skill guides WWST certification for hub-connected products that use Zigbee, Matter, or Z-Wave through SmartThings Hub.
Key features
- Standard vs Custom path guidance
- Developer Console and Test Suite workflow
- Zigbee Edge driver PR worked example
- Capability mapping and certification guidance
Best fit
- Hub-connected products using Zigbee, Matter, or Z-Wave
- Teams preparing WWST certification or driver contribution work
Skill:
smartthings-direct-connected-device-sdk-c-developer
This skill guides SmartThings Direct Connected integration using the SmartThings Device SDK for C over MQTT.
Key features
- IoT core device library vs SDK Reference starting guidance
- Porting boundary and application layer guidance
- Console setup and onboarding asset guidance
- Device identity registration and WWST prerequisites
Best fit
- Direct Connected products using the SmartThings Device SDK for C
- Teams working on porting, provisioning, and certification readiness
Skill:
smartthings-device-onboarding-qr
This skill explains SmartThings device onboarding QR requirements across Matter, Zigbee 3.0, Direct Connected, and Mobile Connected products.
Key features
- Integration-type-specific QR payload guidance
- Zigbee minimum vs recommended payload coverage
- Direct Connected and Mobile Connected QR field guidance
- Product-oriented payload examples and partner publication notes
Best fit
- Teams defining device labels and onboarding assets
- Developers validating QR payload fields before publication
- Partners handling Matter, Zigbee 3.0, Direct Connected, or Mobile Connected onboarding flows
Skill:
smartthings-app-to-app-linking-developer
This skill guides mobile app developers in implementing seamless App-to-App Account Linking between native Android/iOS applications and the SmartThings app, specifically for Cloud Connected (ST-Schema) integrations.
Key features
- Associated Domains and Digital Asset Links (
assetlinks.json/ AASA) validation and configurations - Native Android Manifest intent filters and Kotlin code templates for intent parsing and callback assembly
- Xcode capabilities and Swift UserActivity delegate handling for iOS callback routing
- Support instructions for new vs. already certified Schema Apps
- Developer Mode setup and end-to-end device testing workflows
Best fit
- Mobile application developers building native smart home apps for Android and iOS
- Teams integrating ST-Schema apps looking to enable App-to-App account linking
SmartThings Developer AI Skills provide development guidance and code generation support for SmartThings device integration. Before applying their output, verify the relevant content with the official SmartThings documentation, Developer Console, SmartThings CLI, and real-device testing.
If you find a bug, have a suggestion for improvement, or encounter issues while using the skills, please create an Issue in this repository. Your feedback is highly appreciated and will help us improve the skills.
wwst-skills/
├── README.md # README
├── skills/ # Skills
│ ├── smartthings-cloud-connected-developer/
│ ├── smartthings-direct-connected-device-sdk-c-developer/
│ ├── smartthings-device-onboarding-qr/
│ ├── smartthings-hub-connected-developer/
│ └── ...