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