https://github.com/roquerodrigo/ha-integration-dev-skill
Claude Code plugin for developing Home Assistant custom integrations
https://github.com/roquerodrigo/ha-integration-dev-skill
Last synced: 1 day ago
JSON representation
Claude Code plugin for developing Home Assistant custom integrations
- Host: GitHub
- URL: https://github.com/roquerodrigo/ha-integration-dev-skill
- Owner: roquerodrigo
- Created: 2026-05-29T14:27:33.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-01T03:40:02.000Z (about 1 month ago)
- Last Synced: 2026-06-01T04:11:11.467Z (about 1 month ago)
- Size: 23.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ha-integration-dev-skill
A Claude Code plugin that teaches Claude the conventions, architecture, and
testing patterns for building **Home Assistant custom integrations** and their
companion Python SDKs.
The patterns target **Platinum** on the HA Integration Quality Scale and
assume a shared blueprint (e.g. `ha-integration-blueprint`) as the starting
point for each new integration.
## What's inside
A single skill — `ha-integration-dev` — that auto-loads when Claude Code is
working in a repo containing `custom_components//` or in a related
Python SDK. The skill bundles:
- **Architecture** — file layout, runtime data, coordinator, config/options
flow, entity design, exception hierarchy, translations, diagnostics, HACS.
- **Coding conventions** — strict typing, naming, imports, properties,
logging, error messages, Conventional Commits, `pyproject.toml` template.
- **Testing patterns** — test layout, coverage gates, `conftest.py` pattern,
mocking strategy, translation parity tests, CI/CD jobs.
- **Code review checklist** — per-area checklist for PR review.
- **New integration scaffolding** — step-by-step checklist to fork a
blueprint into a fresh integration.
Reference files are loaded on demand by Claude — only what's relevant to the
current task ends up in context.
## Installation
In a Claude Code session:
```text
/plugin marketplace add roquerodrigo/ha-integration-dev-skill
/plugin install ha-integration-dev
```
After install, start a session inside any HA integration repo and the skill
loads automatically when its triggers match.
## When the skill triggers
- Repos containing `custom_components//`
- Companion Python SDKs that wrap a device or cloud API for such an
integration
- Conversations mentioning: HACS, config flow, coordinator, reauth,
translations, quality scale, or other HA integration concepts
## When it does NOT trigger
The skill explicitly steps aside for:
- Home Assistant core development (`home-assistant/core`)
- Third-party integrations that visibly do not follow the blueprint layout
- HA YAML configuration, automations, and dashboards (user-side, not Python)
## Layout
```
.claude-plugin/marketplace.json
plugins/ha-integration-dev/
├── .claude-plugin/plugin.json
└── skills/ha-integration-dev/
├── SKILL.md
└── references/
├── architecture.md
├── coding-conventions.md
├── testing.md
├── code-review.md
└── new-integration.md
```
## License
MIT