homeassistant-ai/skills

Home Assistant Agent Skills – 概要

Home Assistant Agent Skills は、AI コーディングアシスタント（Claude Code、GitHub Copilot、Gemini CLI など）向けの スキル を提供する小さなオープンソースパッケージです。Agent Skills エコシステムでは、スキル は Markdown ベースの知識パックであり、アシスタントが実行時にロードしてコード生成をガイドするために使用できます。この特定のスキルは、Home Assistant の自動化、ダッシュボード、バックアップ、AppDaemon アプリなどを書くためのベストプラクティスパターンをアシスタントに教えます。

仕組み

インストール – npx skills add homeassistant-ai/skills コマンド（または Claude Code のプラグインマーケットプレイス経由）でリポジトリを追加します。インストーラーがスキルのファイルをアシスタントのスキルディレクトリにコピーします。
自動アクティベーション – インストール後、アシスタントが Home Assistant 設定（自動化、スクリプト、ダッシュボード、ブループリントなど）を作成または編集するように求められるたびに、自動的にスキルを参照します。追加のコマンドは不要です。
コンテンツ – スキルの中核は SKILL.md で、意思決定ワークフローと、一般的な間違い（例：ネイティブの numeric_state 条件が存在する場合に Jinja テンプレートを使用する）と正しい Home Assistant ネイティブの代替案をリストした「アンチパターン」テーブルが含まれています。サポート参照ファイル（Markdown と YAML の例ファイル）は、トリガー、ヘルパー、ダッシュボード、バックアップ、AppDaemon などについてのより深いガイダンスを提供します。

得られるもの

部分	提供内容
`SKILL.md`	高レベルのワークフローと、落とし穴と正しいネイティブ構造のクイックリファレンステーブル。
`references/…`	特定のトピックに関する詳細な Markdown ガイド – トリガー、アクション、ヘルパー選択、安全なリファクタリング、ダッシュボードデザイン、AppDaemon、ブループリント、バックアップなど。
`examples.yaml`	いくつかのベストプラクティス推奨事項を組み合わせた既製の YAML スニペット。

AI アシスタントがスキルに従うと、例えば、テンプレートベースの条件をネイティブの numeric_state 条件に置き換え、Home Assistant が設定をロードするときに検証されるようにします。

対象ユーザー

Home Assistant 開発者 – AI ツールを使用して自動化を構築したり設定をリファクタリングしたりし、生成されたコードがコミュニティ承認済みのパターンに従うことを望む方。
AI コーディングアシスタントユーザー（Claude Code、Copilot、Gemini CLI など） – ドメイン固有のガイダンスでアシスタントの知識を拡張したい方。
コントリビューター – より広い Agent Skills エコシステムに Home Assistant 固有のスキルを追加または改善したい方。

はじめに

Node.js 22.20+ をインストールします。
npx skills add homeassistant-ai/skills を実行します（または Claude Code のプラグインコマンドでインストール）。
アシスタントの「クラウドコード実行」機能が有効になっていることを確認します（スキルに必要）。
アシスタントに Home Assistant の自動化を作成するよう依頼します – スキルのベストプラクティスルールが自動的に適用されます。

ライセンス

MIT – 自由に使用、変更、共有できます。