mcpField
H
home-assistant-esphome

home-assistant-esphome

github.com/bradsjmその他46652 回インストール16 週間前に更新
リポジトリ

home-assistant-esphome について

ESPHome と Home Assistant のデバイス設定、トラブルシューティング、自動化を支援するスキルです。エンティティの確認や YAML の変更手順に加え、Noise PSK 生成スクリプトも含みます。

主な機能

  1. 01デバイス導入や YAML 変更の手順
  2. 02ESPHome の統合、エンティティ、デバイスの確認
  3. 03ESPHome Device Builder での YAML 編集と検証
  4. 04Noise PSK 生成スクリプト
  5. 05設定やトラブルシューティングの参考資料

活用シーン

  1. 01デバイスの Home Assistant への導入
  2. 02ESPHome デバイスのオフライン調査
  3. 03デバイス YAML の変更と検証
  4. 04ESPHome エンティティを使った自動化の作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bradsjm/hassio-addons --skill home-assistant-esphome

インストール後、Claude Code で/home-assistant-esphomeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
ha-config-flow.md
resources.md
snippets.md
troubleshooting.md
scripts/
gen_esphome_noise_psk.py

詳細

ESPHome + Home Assistant

ワークフロー

  • タスクを特定します：新しいデバイスの追加・採用、オフライン時のトラブルシューティング、または YAML の機能変更です。
  • HA 側で検証する場合は、名前を変更する前に ESPHome のエンティティを見つけ、デバイスに対応付けます。
  • YAML を変更する場合は、ESPHome Device Builder（UI を優先）で編集して検証し、その後インストールします（初回のフラッシュは USB、それ以降は OTA）。
  • ESPHome のエンティティからオートメーションを作成する場合は、オートメーションのパターンについて home-assistant-best-practices に従います。

HA 側での検出（一般的なケース）

  • インテグレーションの状態を確認します：ha_get_integration(query="esphome")
  • 名前またはエリアでエンティティを検索します：ha_search_entities(query="kitchen", limit=50)
  • エンティティをデバイスに対応付けます：ha_get_device(entity_id="...")

ローカルヘルパー（同梱）

参照ファイルとスクリプトファイルはすべて、この SKILL.md ファイルの場所からの相対パスです。

  • 新しい base64 32 バイトキーを生成します：
    • Raw：python3 scripts/gen_esphome_noise_psk.py
    • YAML ブロック：python3 scripts/gen_esphome_noise_psk.py --yaml

参考資料

  • コアリソースとドキュメント：references/resources.md
  • YAML のスニペットと命名パターン：references/snippets.md
  • トラブルシューティング：references/troubleshooting.md
  • HA の設定フローの詳細：references/ha-config-flow.md

コメント

Markdown 対応