An Agent Skill is a plugin that teaches AI coding agents best practices for a specific technology, delivered as a portable Markdown knowledge pack.
This repository provides an Agent Skill for Home Assistant, following the open Agent Skills standard. Install a skill and your agent gains Home Assistant best practices that persist across sessions.
home-assistant-best-practices: Native HA constructs over templates, helper selection, automation modes, Zigbee button patterns, device control best practices, and safe refactoring.
Requires Node.js 18+.
npx skills add homeassistant-ai/skillsWorks with AI coding agents that support the Agent Skills standard: Claude Code, Cursor, Copilot, VS Code, Gemini CLI, and others. To update: npx skills update
Run each command separately inside Claude Code:
/plugin marketplace add homeassistant-ai/skills
/plugin install home-assistant-skills@homeassistant-ai-skills
Restart Claude Code after installation for the skill to take effect.
- Download or clone this repository
- Zip the skill folder:
cd skills && zip -r home-assistant-best-practices.zip home-assistant-best-practices/ - Settings → Capabilities → Skills → Upload skill → select the
.zipfile
The home-assistant-best-practices skill includes:
| File | Purpose |
|---|---|
SKILL.md |
Decision workflow and quick-reference routing |
references/safe-refactoring.md |
Safe workflow for renaming entities, replacing helpers, restructuring automations |
references/automation-patterns.md |
Native conditions, triggers, waits, automation modes |
references/helper-selection.md |
Built-in helpers vs template sensors (with decision matrix) |
references/template-guidelines.md |
When templates are the right choice |
references/device-control.md |
Service calls, entity_id vs device_id, Zigbee buttons |
references/examples.yaml |
Compound examples combining multiple best practices |
See CONTRIBUTING.md for guidelines on writing and submitting skills.
MIT