Community-maintained Claude Code skill for Indigo home automation plugin development.
This is a Claude Code skill that provides expert assistance for developing Indigo home automation plugins. It includes comprehensive documentation, code examples, and best practices maintained by the Indigo developer community.
cd /path/to/your/indigo/project
mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/simons-plugins/indigo-claude-skill.git indigocd /path/to/your/indigo/project
mkdir -p .claude/skills
git submodule add https://github.com/simons-plugins/indigo-claude-skill.git .claude/skills/indigo# Clone once
git clone https://github.com/simons-plugins/indigo-claude-skill.git ~/indigo-skill
# Symlink in each project
cd /path/to/your/indigo/project
mkdir -p .claude/skills
ln -s ~/indigo-skill .claude/skills/indigoOnce installed, invoke the skill in Claude Code:
/indigo "How do I create a custom device?"
/indigo "Debug this plugin lifecycle issue"
/indigo "Show me an example of a thermostat plugin"
/indigo "What's the best way to poll an API?"
The skill has access to:
- 16 official SDK example plugins - Complete, working examples
- Official SDK documentation - Organized by topic
- Community documentation - Guides and best practices
- Code snippets and templates - Ready-to-use code
- Troubleshooting guides - Common issues and solutions
Complete, production-quality example plugins from the official Indigo SDK:
- Device Types: Custom, Relay, Dimmer, Thermostat, Sensor, Speed Control, Sprinkler, Energy Meter
- Integration: HTTP Responder, Action API, Custom Broadcaster/Subscriber, Variable Subscriber
- Hardware: INSTEON/X10, Z-Wave listeners
- Advanced: Database Traverse, Device Factory
See sdk-examples/README.md for the complete catalog.
Complete Indigo SDK documentation organized by topic:
- Getting started guides
- Plugin development patterns
- API reference materials
- Troubleshooting guides
Community-contributed guides and resources:
- Plugin templates and snippets
- Implementation patterns
- Best practices
- Additional examples
All documentation is organized in the docs/ directory:
New to Indigo plugin development? Start here!
- Setting up your development environment
- Creating your first plugin
- Understanding plugin structure
- Testing and debugging
Understanding the architecture and lifecycle
- Plugin lifecycle (init, startup, shutdown)
- Device types (custom, relay, dimmer, sensor, thermostat)
- State management
- Concurrent thread patterns
Detailed API documentation
- Plugin base class methods
- Device object properties
- Action callbacks
- UI validation callbacks
🎯 Patterns
Common implementation patterns
- API integration techniques
- Polling strategies
- Error handling approaches
- Configuration UI patterns
💡 Examples
Complete working examples
- Custom device implementations
- Relay and dimmer devices
- Thermostat controllers
- Sensor devices
- HTTP responders
Common issues and solutions
- Debugging techniques
- Performance optimization
- Common errors and fixes
We welcome contributions from the Indigo developer community! See CONTRIBUTING.md for guidelines.
- 📝 Documentation improvements
- 💻 Code examples and snippets
- 🐛 Troubleshooting guides
- 📚 Best practices
- 🎯 Design patterns
- Fork the repository
- Create a feature branch (
git checkout -b docs/add-device-state-guide) - Make your changes
- Submit a pull request
- Current: Indigo 2023.2+ (Python 3.10+)
- Legacy: Indigo 2022.x and earlier (Python 2.7)
This skill focuses on current versions. Version-specific documentation is in the versions/ directory.
- 💬 Discussions: Ask questions, share tips
- 🐛 Issues: Report bugs or request documentation
- 🌐 Forum: Indigo Developer Forum
MIT License - See LICENSE
This is a community project. Want to help maintain? Open an issue or discussion!
Made with ❤️ by the Indigo developer community