Agent skill

Hass Builder

by aahl in aahl/skills

A skill to build and manage Home Assistant configurations. An agent skill from aahl/skills.

MITAuto-check passedDevOps & Cloud

Install Hass Builder

skills CLI
$ npx skills add aahl/skills --skill hass-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aahl/skills hass-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aahl/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hass-builder .claude/skills/hass-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hass-builder
GitHub stars
162
Used in
1 other repo
Token cost
~1.4k tokens
SKILL.md length
519 words
Files
2 (incl. scripts)
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

A skill to build and manage Home Assistant configurations. An agent skill from aahl/skills.

  • Works in 5 steps: Read the guide/schema for the command. → Gather current state with read-only… → Preview the mutation with --plan or… → …
  • Using the Home Assistant Builder (hab) CLI to inspect
  • SKILL.md covers Start Every Workflow, Output and Parsing, Mutations and Risk Gates and Input Payloads, plus 3 more sections
  • Runs Shell scripts from its folder

What it does

Hass Builder is an agent skill from aahl/skills. 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.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/hab.sh`).

It sits in DevOps & Cloud, covering Backup and disaster recovery. It works with Home Assistant. The repository describes itself as: AAHL's Agent Skills. 汇集了多种实用的智能体技能,涵盖Home Assistant智能家居控制、微软Edge TTS和智谱GLM-TTS文本转语音、DuckDuckGo搜索、DeepWiki文档检索、加密货币行情、天气预报、Lark/飞书、影视搜索、商品比价等功能. The licence is MIT.

When your agent uses it

  • Using the Home Assistant Builder (hab) CLI to inspect
  • Troubleshoot Home Assistant resources
  • A user mentions hab
  • Home Assistant CLI automation

Example prompts

  • “/hass-builder”

Requirements

  • A Bash shell

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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.

What it can do on your machine

Read from SKILL.md and the folder at commit 47edd62. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hass Builder loads about 1.4k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 519 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~98
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from aahl/skills at commit 47edd62, republished under its MIT licence (© aahl). 519 words, ~1,350 tokens.

Download SKILL.mdSave it as .claude/skills/hass-builder/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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:

TaskFirst commands
Discovery / inventoryhab guide discovery; hab schema entity list
Automation / script / scenehab guide automation; hab schema automation create --json
Dashboard / Lovelacehab guide dashboard; hab schema dashboard card create --json
Helpershab guide helpers; hab helper types --json
Calendar / to-dohab guide calendar-todo
Backups / system / networkhab guide operations; hab schema system restart
ESPHomehab 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.

Show full SKILL.md (186 more words)Show less

Input Payloads

Commands that accept data usually support:

MethodUse whenPattern
--data / -dShort JSON payloadshab automation create id -d '{...}' --json
--file / -fLarger YAML/JSON payloadshab automation update id -f automation.yaml
stdin heredocMulti-line payload without temp filehab 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

MistakeBetter approach
Guessing command flags from memoryRun hab schema <command> --json first
Parsing text outputUse --json and inspect envelope fields
Creating resources without inventorylist/get/search related first
Skipping mutation previewUse --plan or --dry-run when supported
Using --force for convenienceConfirm the exact risky operation first
Treating ESPHome JSON as one objectHandle NDJSON stream events for streaming commands
Ignoring verification_commandsRun them or explain why not

© aahl, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/hass-builder of aahl/skills.

  • SKILL.md
  • scripts/hab.sh

Open the folder on GitHubat commit 47edd62

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in aahl/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hass Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hass Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hass Builder this skillaahl/skills1621 repos~1.4kAutomated safety check: PassMIT
OmniRoute Backup and Sync CLIdiegosouzapw/OmniRoute74k—~948Automated safety check: PassMIT
OmniRoute Database Backupsdiegosouzapw/OmniRoute74k1 repos~395Automated safety check: PassMIT
Pymobiledevice3 Device Operatordoronz88/pymobiledevice32.8k—~1.8kAutomated safety check: NotesGPL-3.0
Myclaw BackupLeoYeAI/openclaw-backup659—~1.8kAutomated safety check: PassMIT
Tempsgotempsh/temps826—~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated today
    DevOps & CloudAuto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub starsUsed in 1 repo~395 tokens
    DevOps & CloudAuto-check passed
  • Pymobiledevice3 Device Operator

    doronz88/pymobiledevice3

    Operate iOS and iPadOS devices with pymobiledevice3, from a local checkout or straight from PyPI via uvx on a fresh workstation.

    2.8k GitHub stars~1.8k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Myclaw Backup

    LeoYeAI/openclaw-backup

    Backup and restore all OpenClaw configuration, agent memory, skills, and workspace data.

    659 GitHub stars~1.8k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed
  • Temps

    gotempsh/temps

    Manage, deploy, operate, and instrument applications with Temps.

    826 GitHub stars~1.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Hermes Offsite Backup

    OnlyTerp/hermes-optimization-guide

    Set up encrypted off-machine Hermes backups. An agent skill from OnlyTerp/hermes-optimization-guide.

    683 GitHub stars~772 tokensUpdated 14 days ago
    DevOps & CloudAuto-check passed

More from aahl/skills

All 13 skills in this repo
  • Edge Tts

    aahl/skills

    Text-to-speech conversion using uvx edge-tts for generating audio from text.

    162 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Maishou

    aahl/skills

    商品价格全网对比技能,获取商品在淘宝(Taobao)、天猫(TMall)、京东(JD.com)、拼多多(PinDuoDuo)、抖音(Douyin)、快手(KaiShou)的最优价格、优惠券,当用户想购物或者获取优惠信息时使用。Get the best price, coupons for goods on Chinese e-commerce platforms, compare…

    162 GitHub starsUsed in 2 repos~175 tokens
    Auto-check passed
  • MCP Deepwiki

    aahl/skills

    Skills for accessing and searching docs in DeepWiki/GitHub’s public code repositories can help users understand open-source project source codes, and users can also ask questions directly about the…

    162 GitHub starsUsed in 2 repos~607 tokens
    Auto-check passed
  • Zai Tts

    aahl/skills

    Text-to-speech conversion using GLM-TTS service via the uvx zai-tts command for generating audio from text.

    162 GitHub starsUsed in 1 repo~385 tokens
    Auto-check passed
  • MCP Hass

    aahl/skills

    The skill for control Home Assistant smart home devices and query states using MCP protocol.

    162 GitHub starsUsed in 2 repos~568 tokens
    Auto-check passed
  • MCP Lark

    aahl/skills

    Based on FeiShu(飞书) / Lark's OpenAPI MCP server, manage user information, chats, emails, cloud documents, multidimensional tables, tasks, calendars, etc.

    162 GitHub starsUsed in 1 repo~387 tokens
    Auto-check: notes

Works with

Categories

Questions about Hass Builder

What does Hass Builder do?

A skill to build and manage Home Assistant configurations. An agent skill from aahl/skills. Hass Builder is an agent skill from aahl/skills. A skill to build and manage Home Assistant configurations.

When should I use Hass Builder?

Hass Builder fits situations like: using the Home Assistant Builder (hab) CLI to inspect; troubleshoot Home Assistant resources; A user mentions hab; home Assistant CLI automation.

How do I install Hass Builder in Claude Code?

Run `npx skills add aahl/skills --skill hass-builder -a claude-code`. Or copy the skill folder (skills/hass-builder in aahl/skills) into .claude/skills/hass-builder in your project. Claude Code loads it when a task matches its description.

How do I install Hass Builder in Codex?

Run `npx skills add aahl/skills --skill hass-builder -a codex`. Or copy the skill folder (skills/hass-builder in aahl/skills) into .agents/skills/hass-builder in your project. Codex loads it when a task matches its description.

Can I use Hass Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aahl/skills --skill hass-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hass-builder, .gemini/skills/hass-builder, .github/skills/hass-builder and .opencode/skills/hass-builder in your project.

What does Hass Builder need to run?

Going by SKILL.md and its folder, Hass Builder needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Hass Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hass Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Hass Builder use?

Hass Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hass Builder use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hass Builder?

Skills that share tags, products or a category with Hass Builder: OmniRoute Backup and Sync CLI (diegosouzapw/OmniRoute, 74k stars), OmniRoute Database Backups (diegosouzapw/OmniRoute, 74k stars), Pymobiledevice3 Device Operator (doronz88/pymobiledevice3, 2.8k stars) and Myclaw Backup (LeoYeAI/openclaw-backup, 659 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hass Builder?

aahl (a GitHub organization) maintains it in aahl/skills, which has 162 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 15, 2026.

Source: aahl/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.