# unknown

> Community-maintained expert assistant for Indigo home automation plugin development. Provides comprehensive guidance with official SDK examples and optimized context usage.

- Author: simons-plugins
- Repository: simons-plugins/indigo-claude-skill
- Version: 20260131090721
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/simons-plugins/indigo-claude-skill
- Web: https://mule.run/skillshub/@@simons-plugins/indigo-claude-skill~unknown:20260131090721

---

# Indigo Plugin Development Skill

Community-maintained Claude Code skill for Indigo home automation plugin development.

## What is This?

This is a Claude Code skill that provides expert assistance for developing [Indigo](https://www.indigodomo.com) home automation plugins. It includes comprehensive documentation, code examples, and best practices maintained by the Indigo developer community.

## Installation

### Option 1: Clone into your project

```bash
cd /path/to/your/indigo/project
mkdir -p .claude/skills
cd .claude/skills
git clone https://github.com/simons-plugins/indigo-claude-skill.git indigo
```

### Option 2: Add as submodule

```bash
cd /path/to/your/indigo/project
mkdir -p .claude/skills
git submodule add https://github.com/simons-plugins/indigo-claude-skill.git .claude/skills/indigo
```

### Option 3: Symlink (for multiple projects)

```bash
# 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/indigo
```

## Usage

Once 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

## What's Included

### 📦 16 Official SDK Examples (`sdk-examples/`)
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`](sdk-examples/README.md) for the complete catalog.

### 📚 Official SDK Documentation (`docs/sdk/`)
Complete Indigo SDK documentation organized by topic:
- Getting started guides
- Plugin development patterns
- API reference materials
- Troubleshooting guides

### 📖 Community Documentation (`docs/`)
Community-contributed guides and resources:
- Plugin templates and snippets
- Implementation patterns
- Best practices
- Additional examples

## Documentation

All documentation is organized in the `docs/` directory:

### 📚 [Quick Start](docs/quick-start.md)
New to Indigo plugin development? Start here!
- Setting up your development environment
- Creating your first plugin
- Understanding plugin structure
- Testing and debugging

### 🏗️ [Core Concepts](docs/concepts/)
Understanding the architecture and lifecycle
- Plugin lifecycle (init, startup, shutdown)
- Device types (custom, relay, dimmer, sensor, thermostat)
- State management
- Concurrent thread patterns

### 📖 [API Reference](docs/api/)
Detailed API documentation
- Plugin base class methods
- Device object properties
- Action callbacks
- UI validation callbacks

### 🎯 [Patterns](docs/patterns/)
Common implementation patterns
- API integration techniques
- Polling strategies
- Error handling approaches
- Configuration UI patterns

### 💡 [Examples](docs/examples/)
Complete working examples
- Custom device implementations
- Relay and dimmer devices
- Thermostat controllers
- Sensor devices
- HTTP responders

### 🔧 [Troubleshooting](docs/troubleshooting/)
Common issues and solutions
- Debugging techniques
- Performance optimization
- Common errors and fixes

## Contributing

We welcome contributions from the Indigo developer community! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

### What to contribute:
- 📝 Documentation improvements
- 💻 Code examples and snippets
- 🐛 Troubleshooting guides
- 📚 Best practices
- 🎯 Design patterns

### How to contribute:
1. Fork the repository
2. Create a feature branch (`git checkout -b docs/add-device-state-guide`)
3. Make your changes
4. Submit a pull request

## Version Support

- **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.

## Community

- 💬 **Discussions**: Ask questions, share tips
- 🐛 **Issues**: Report bugs or request documentation
- 🌐 **Forum**: [Indigo Developer Forum](https://forums.indigodomo.com/viewforum.php?f=18)

## Official Resources

- [Indigo Plugin Developer's Guide](https://www.indigodomo.com/docs/plugin_guide)
- [Indigo Object Model Reference](https://www.indigodomo.com/docs/object_model_reference)
- [Indigo Scripting Tutorial](https://www.indigodomo.com/docs/plugin_scripting_tutorial)

## License

MIT License - See [LICENSE](LICENSE)

## Maintainers

This is a community project. Want to help maintain? Open an issue or discussion!

---

**Made with ❤️ by the Indigo developer community**