Навык агента — это портативный набор знаний Markdown, который обучает лучшим практикам агентов кодирования ИИ для конкретной технологии. Этот репозиторий предоставляет такой набор для Home Assistant, следуя открытому стандарту Agent Skills. Установите его, и ваш агент применяет лучшие практики Home Assistant в каждой сессии.

Включённое мастерство

home-assistant-best-practices — рабочий процесс принятия решений и таблица антипаттернов в SKILL.md, поддерживаемая справочными файлами, которые агент загружает по требованию. Она охватывает:

• Авторинг — нативные триггеры и условия для шаблонов, выбор помощников, режимы автоматизации, управление устройством и шаблоны кнопок/пультов, сцены, чертежи
• Дашборды — макет, виды, карты, значки, пользовательские карты
• Операции — управление интеграцией, резервное копирование и восстановление только с YAML, безопасная рефакторинг существующей конфигурации
• AppDaemon — когда использовать его поверх нативного HA и как структурировать приложения

Home Assistant Agent Skills

An Agent Skill is a portable Markdown knowledge pack that teaches AI coding agents best practices for a specific technology. This repository provides one for Home Assistant, following the open Agent Skills standard. Install it and your agent applies Home Assistant best practices in every session.

Included Skill

home-assistant-best-practices — a decision workflow and anti-pattern table in SKILL.md, backed by reference files the agent loads on demand. It covers:

• Authoring — native triggers and conditions over templates, helper selection, automation modes, device control and button/remote patterns, scenes, blueprints
• Dashboards — layout, views, cards, badges, custom cards
• Operations — YAML-only integration management, backups and recovery, safe refactoring of existing config
• AppDaemon — when to use it over native HA, and how to structure apps

Agents make a predictable set of mistakes with Home Assistant config — Jinja templates where a native trigger, condition, or helper exists, device_id where entity_id belongs, mode: single on a motion light, renames that silently break dashboards and scripts — and the anti-pattern table names each one with its fix. A typical entry:

# Without the skill: a template condition. HA checks only the Jinja syntax when the automation loads
condition: template
value_template: "{{ states('sensor.living_room_temperature') | float > 25 }}"

# With the skill: a native condition. HA checks every key, the entity ID format and the threshold when it loads
condition: numeric_state
entity_id: sensor.living_room_temperature
above: 25

See Skill Contents for the file-by-file map.

Installation

Agent Skills installer

Requires Node.js 22.20+.

npx skills add homeassistant-ai/skills

Works with AI coding agents that support the Agent Skills standard: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and 70+ others. It installs into the current project; add -g to install it for all projects. To update: npx skills update

Claude Code plugin

Claude Code also accepts the installer above, which places the skill files in your .claude/skills/ directory. The commands below install it as a plugin instead, kept in Claude Code’s own plugin cache.

Run each command separately inside Claude Code:

/plugin marketplace add homeassistant-ai/skills

/plugin install home-assistant-skills@home-assistant-skills

Run /reload-plugins or restart Claude Code for the skill to take effect.