エージェントスキルは、特定の技術に関するAIコーディングエージェントのベストプラクティスを教える、ポータブルなMarkdownナレッジパックです。このリポジトリは、オープンなエージェントスキル標準に準拠したHome Assistant向けのものを提供しています。インストールすると、エージェントは毎回のセッションでHome Assistantのベストプラクティスを適用します。

スキルの含み込み

home-assistant-best-practices — SKILL.mdで作成された意思決定ワークフローおよびアンチパターンテーブルで、エージェントがオンデマンドで読み込む参照ファイルによって裏付けられています。対象は以下の通りです:

• オーサリング — テンプレート上のネイティブトリガーや条件、ヘルパー選択、自動化モード、デバイス制御、ボタン/リモコンパターン、シーン、設計図
• ダッシュボード — レイアウト、ビュー、カード、バッジ、カスタムカード
• Operations — 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.