Home Assistant Manager

What it does

When your agent uses it

• Editing Home Assistant automations, scripts, scenes or templates
• Deploying configuration changes and deciding between a reload and a restart
• Building or adjusting a Lovelace dashboard
• Checking from logs and traces that an automation change actually worked

Example prompts

• “Add an automation that turns on the hallway light when motion is detected after sunset, then deploy it.”
• “Validate my configuration and tell me whether I need a restart or just a reload.”
• “Why didn't the garage door automation fire last night? Check the traces.”

Requirements

• A Home Assistant instance reachable over SSH, hass-cli or an MCP server
• The Home Assistant config directory kept in a git repository

Workflow steps

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

1. 1Edit YAML locally.
2. 2Validate: ssh root@homeassistant.local "ha core check" (slow, ~30-60s — see "when to
3. 3Commit + push: git add … && git commit -m "…" && git push.
4. 4Make it live: ssh root@homeassistant.local "cd /config && git pull".
5. 5Apply: reload if possible, else restart (table below).
6. 6Verify (next section).

What it can do on your machine

Read from SKILL.md and the folder at commit 2112679. 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

  Shell commands in SKILL.md call:

  • ssh
  • git
  • scp
  • python3

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

• Network

  No URLs in SKILL.md. Its commands use ssh, git and scp, which can reach the network depending on how they are called.

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

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • HASS_TOKEN

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

Context cost

Home Assistant Manager loads about 1.8k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 801 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~106

When it runs · the whole SKILL.md, loaded when a task matches

~1.8k

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

• WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:15

  (project CLAUDE.md, `~/.ssh/config`, or ask) and if it isn't recorded in the project

• NoteMentions a .env fileSKILL.md:18

  `.yaml`/`.yml`/`.md`. Never read/write `.env` or `secrets.yaml`; use `!secret`.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from komal-SkyNET/claude-skill-homeassistant at commit 2112679, republished under its MIT licence (© komal-SkyNET). 801 words, ~1,779 tokens.

name

home-assistant-manager

description

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 build Lovelace dashboards. Use for any Home Assistant config, automation, template, or dashboard work over SSH/hass-cli/MCP.

# Validate / apply
ssh root@homeassistant.local "ha core check"
ssh root@homeassistant.local "ha core restart"
ssh root@homeassistant.local "cd /config && git pull"     # make pushed changes live

# Logs
ssh root@homeassistant.local "ha core logs | grep -iE 'error|<name>' | tail -20"

# State / services (needs env loaded, or use MCP)
hass-cli state get <entity>
hass-cli service call <domain>.reload
hass-cli service call automation.trigger --arguments entity_id=automation.<id>

# Rapid deploy
scp <file>.yaml root@homeassistant.local:/config/ && hass-cli service call automation.reload

© komal-SkyNET, 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 3 other files in skills/home-assistant-manager of komal-SkyNET/claude-skill-homeassistant.

• SKILL.md
• dashboard.png
• reference/automations.md
• reference/dashboards.md

Open the folder on GitHubat commit 2112679