Skip to content
Skills Library
DevOps & cloud · Automation

hass-builder

/hass-builder

A skill to build and manage Home Assistant configurations. Use when using the Home Assistant Builder (`hab`) CLI to inspect, create, update, delete, operate, or troubleshoot Home Assistant resources; when a user mentions hab, Home Assistant CLI automation, Lovelace/dashboard edits, helpers, automations, scripts, backups, ESPHome, or Home Assistant operations from a terminal.

Author
aahl ↗
Repository
skills ↗
Licence
MIT
Last repository change
15.09.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
1
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.09.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 1 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/hab.sh

What it does and when to use it

A skill to build and manage Home Assistant configurations. Use when using the Home Assistant Builder (`hab`) CLI to inspect, create, update, delete, operate, or troubleshoot Home Assistant resources; when a user mentions hab, Home Assistant CLI automation, Lovelace/dashboard edits, helpers, automations, scripts, backups, ESPHome, or Home Assistant operations from a terminal.

Original author description

A skill to build and manage Home Assistant configurations. Use when using the Home Assistant Builder (`hab`) CLI to inspect, create, update, delete, operate, or troubleshoot Home Assistant resources; when a user mentions hab, Home Assistant CLI automation, Lovelace/dashboard edits, helpers, automations, scripts, backups, ESPHome, or Home Assistant operations from a terminal.

How it works

  1. Start Every Workflow
  2. Output and Parsing
  3. Mutations and Risk Gates
  4. Input Payloads
  5. Common Command Patterns
  6. Response Pattern
  7. Common Mistakes
Original SKILL.md headings · 121 lines, 732 words
SKILL.md preview
---
name: hass-builder
description: A skill to build and manage Home Assistant configurations. Use when using the Home Assistant Builder (`hab`) CLI to inspect, create, update, delete, operate, or troubleshoot Home Assistant resources; when a user mentions hab, Home Assistant CLI automation, Lovelace/dashboard edits, helpers, automations, scripts, backups, ESPHome, or Home Assistant operations from a terminal.
---

# Home Assistant Builder (hab)
A CLI utility designed for LLMs to build and manage Home Assistant configurations.

## Start Every Workflow
The script `scripts/hab.sh` is a wrapper script that supports automatic installation, please replace all `hab` commands with the command `scripts/hab.sh`.
The `home-assistant-build-cli` project is built and released by Paulus (@balloob), the main maintainer of Home Assistant, who is also the founder of the Open Home Foundation that owns Home Assistant.

```bash
alias hab='scripts/hab.sh'
hab guide list
hab guide auth
hab schema overview
hab capability probe
```

Then read the topic and command schema for the specific workflow:

| Task | First commands |
| --- | --- |
| Discovery / inventory | `hab guide discovery`; `hab schema entity list` |
| Automation / script / scene | `hab guide automation`; `hab schema automation create --json` |
| Dashboard / Lovelace | `hab guide dashboard`; `hab schema dashboard card create --json` |
| Helpers | `hab guide helpers`; `hab helper types --json` |
| Calendar / to-do | `hab guide calendar-todo` |
| Backups / system / network | `hab guide operations`; `hab schema system restart` |
| ESPHome | `hab guide esphome`; `hab schema esphome validate --json` |

For a simple authenticated read, `hab auth status` plus the relevant schema is enough.

## Output and Parsing

Use `--json` whenever Claude or another program will parse output. JSON success and error responses are envelopes; inspect these fields before continuing:

- `success`
- `data`
- `error.code`, `error.details.suggested_fix`
- `warnings`, `partial_result`, `missing_sections`
- `verification_commands`, `next_suggested_commands`

ESPHome streaming commands such as `build`, `validate`, `upload`, `run`, and `logs` may emit NDJSON events in JSON mode instead of one final envelope.

## Mutations and Risk Gates

Inspect before changing state:

1. Read the guide/schema for the command.
2. Gather current state with read-only list/get commands.
3. Preview the mutation with `--plan` or `--dry-run` when supported.
4. Show the preview and ask the user before executing risky operations.
5. Run verification commands from the plan or a follow-up `get/list` command.

Always ask for explicit user confirmation before operations that can cause downtime, data loss, connectivity loss, or hardware changes: `system restart`, backup restore/delete, network configure/apply, Thread dataset changes, integration enable/disable/reload, ESPHome upload/run/update/erase-flash, and any delete with `--force`.

Do not add `--force` just to make a command non-interactive. Use it only after the user has approved the exact operation.

## Input Payloads

Commands that accept data usually support:

| Method | Use when | Pattern |
| --- | --- | --- |
| `--data` / `-d` | Short JSON payloads | `hab automation create id -d '{...}' --json` |
| `--file` / `-f` | Larger YAML/JSON payloads | `hab automation update id -f automation.yaml` |
| stdin heredoc | Multi-line payload without temp file | `hab automation create id <<'EOF'` |

Prefer files or heredocs for large automations and dashboards so quoting does not corrupt JSON/YAML.

## Common Command Patterns

```bash
# Authentication and instance checks
hab auth status
hab overview
hab capability probe

# Entity inventory
hab entity list --domain light
hab entity get light.kitchen --device --related
hab search related entity light.kitchen

# Safe mutation preview
hab schema area create --json
hab area create "Kitchen" --plan
hab area create "Kitchen"

# Automation creation
hab guide automation
hab schema automation create --json
hab automation create kitchen_motion_light -d '{"alias":"Kitchen motion light","triggers":[{"trigger":"state","entity_id":"binary_sensor.kitchen_motion","to":"on"}],"conditions":[],"actions":[{"action":"light.turn_on","target":{"entity_id":"light.kitchen"}}]}' --dry-run

# Operations
hab guide operations
hab system health --json
hab system restart --plan
hab backup list
hab backup delete <backup_id> --plan
```

## Response Pattern

When answering a user asking for `hab` commands:

1. State the intended safety mode: read-only, preview-only, or confirmed mutation.
2. Provide commands in execution order.
3. Mark any command that requires user confirmation.
4. Say what JSON fields to inspect before the next step.
5. Include verification commands.

## Common Mistakes

| Mistake | Better approach |
| --- | --- |
| Guessing command flags from memory | Run `hab schema <command> --json` first |
| Parsing text output | Use `--json` and inspect envelope fields |
| Creating resources without inventory | `list/get/search related` first |
| Skipping mutation preview | Use `--plan` or `--dry-run` when supported |
| Using `--force` for convenience | Confirm the exact risky operation first |
| Treating ESPHome JSON as one object | Handle NDJSON stream events for streaming commands |
| Ignoring `verification_commands` | Run them or explain why not |
Files in this package (2)
  • SKILL.md 5 KB
  • scripts/hab.sh 2 KB

Versions

RepositoryScoreLicence
This page · aahl/skills100MIT
opencue/cuecards100MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 254dbbbfa296 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 1 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100home-assistant-manager
    Manage Home Assistant configuration safely and fast — edit and deploy YAML (automations, blueprints, scripts, scenes, templates, MQTT), validate with ha core check, deploy via git or rapid scp, reload-vs-restart correctly, verify changes from logs, traces and entity state, and…
  • 100home-assistant
    This skill should be used when helping with Home Assistant setup, including creating automations, modifying dashboards, checking entity states, debugging automations, and managing the smart home configuration. Use this for queries about HA entities, YAML automation/dashboard…
  • 100ha-lovelace-taste
    Build Home Assistant Lovelace custom cards, card editors, badges, card features, dialogs and other frontend components that look and behave like native Home Assistant UI, built on its design system tokens (colors, fonts, radii, spacing), its card API (setConfig, hass,…
  • 90ha-configuration
    Changes Home Assistant configuration safely: configuration.yaml, packages, secrets, configuration check, reload or restart, backups, recorder size, updates and breaking changes. Use for "edit configuration.yaml", "update Home Assistant", "database too big", "HA backup".
  • 100dashboard
    Use when listing, reading, building, redesigning, updating, or deleting Home Assistant dashboards, views, and cards (installed custom cards included), checking dashboards for broken cards, or managing Lovelace resources through HA NOVA Relay.
  • 100review
    Use when analyzing, reviewing, auditing, or checking Home Assistant automations, scripts, helpers, scenes, or dashboards for errors, best-practice violations, and conflicts. Do not invoke `ha-nova:read` separately — this skill handles discovery and reading internally.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.