mcpField
H
home-assistant-esphome

home-assistant-esphome

github.com/bradsjmOther46652 installsUpdated 16w ago
Repository

About home-assistant-esphome

A workflow skill for ESPHome and Home Assistant users handling device setup, troubleshooting, and automation. It covers entity discovery and YAML changes, and includes a helper script for generating Noise PSKs.

Key features

  1. 01Workflow guidance for device and YAML tasks
  2. 02Discover ESPHome integrations, entities, and devices
  3. 03Edit and validate YAML in ESPHome Device Builder
  4. 04Generate Noise PSKs with a bundled script
  5. 05Reference material for configuration and troubleshooting

Use cases

  1. 01Adopting a device into Home Assistant
  2. 02Troubleshooting an offline ESPHome device
  3. 03Changing and validating device YAML
  4. 04Building automations from ESPHome entities

Install

Copy the command and run it in a terminal.

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

After installing, type/home-assistant-esphomein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

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

Details

From the project README

ESPHome + Home Assistant

Workflow

  • Identify the task: new device/adopt, offline troubleshooting, or YAML feature changes.
  • For HA-side validation, discover ESPHome entities and map to devices before changing names.
  • For YAML changes, edit in ESPHome Device Builder (UI-first), validate, then install (USB first flash, OTA thereafter).
  • When building automations from ESPHome entities, follow home-assistant-best-practices for automation patterns.

HA-side discovery (common)

  • Check integration state: ha_get_integration(query="esphome")
  • Find entities by name or area: ha_search_entities(query="kitchen", limit=50)
  • Map entity to device: ha_get_device(entity_id="...")

Local helper (bundled)

All reference and script files are relative to the location of this SKILL.md file.

  • Generate a new base64 32-byte key:
    • Raw: python3 scripts/gen_esphome_noise_psk.py
    • YAML block: python3 scripts/gen_esphome_noise_psk.py --yaml

References

  • Core resources and docs: references/resources.md
  • YAML snippets and naming patterns: references/snippets.md
  • Troubleshooting: references/troubleshooting.md
  • HA config flow specifics: references/ha-config-flow.md

Comments

Markdown supported