LayerTM

ha-addon

Inspect, diagnose, and manage other Home Assistant add-ons via the Supervisor CLI. Use when asked to list/check/restart an add-on, read an add-on's logs, view its resource usage, or figure out why an add-on is failing, crashing, or unhealthy.

ha-automation

Create or modify Home Assistant automations and scripts. Use when the user wants to automate behavior ("when X happens, do Y"), schedule something, or edit/fix an existing automation or script.

ha-backup

Create Home Assistant backups via the Supervisor before risky or large changes (destructive config edits, integration removals, core updates), or whenever the user asks to back up. Also covers where backups live and how to restore.

ha-blueprint

Import and use Home Assistant blueprints — reusable automation/script templates. Use when asked to import a blueprint from a URL, list installed blueprints, or build an automation from a blueprint (use_blueprint).

ha-debug

Investigate a misbehaving Home Assistant entity, integration, or automation. Use when the user says something in HA isn't working, is erroring, not updating, is unavailable, or stopped responding — pulls errors, inspects state, forms a hypothesis, applies a fix, and verifies.

ha-energy

Analyse Home Assistant energy and power usage — find energy/power sensors, read the Energy dashboard config, and summarise consumption, cost, and top consumers over a period. Use when asked about power draw, kWh, the electricity bill/cost, what's using the most energy, or energy trends.

ha-entity

Query Home Assistant entity states and call services. Use when asked "what's the state of X", to list/filter entities, to turn something on/off, set a value, or call a service.

ha-lovelace-card

Design a Home Assistant Lovelace dashboard card or view and preview it live. Use when the user wants to build, add, or tweak a dashboard card (entities/glance/gauge/history-graph/custom) and see how it looks — write the card YAML, screenshot it with ha-shot, read the PNG, and iterate until it looks right.

ha-onboard

Survey this Home Assistant instance once (version, location, entities by domain, integrations, areas, add-ons, config file layout) and record a concise orientation into /homeassistant/CLAUDE.md so future sessions start informed. Use on first contact with a new HA instance, or when the user says "get to know my setup" / "learn my Home Assistant".

ha-recorder-query

Query a Home Assistant sensor's history and trends from the recorder — pull a time series for an entity and compute its min / max / average / trend. Use when asked how a value changed over time, its high/low/average over a period, or whether it's trending up or down.

ha-screenshot

Capture and visually verify how a Home Assistant dashboard, view, or Lovelace card looks. Use when the user wants to see/check a dashboard's appearance, or after editing Lovelace to confirm the change rendered correctly.

ha-voice

Set up voice control (speech in and out) for Assist in a chosen language — especially Ukrainian, Polish, or any language Home Assistant's English-only default does not offer — using local Whisper (speech-to-text) + Piper (text-to-speech) with Claude as the conversation agent. Use when the user wants to TALK to Claude by voice in their language, or says Assist voice has no option for their language on their phone.