How do I install the Home Assistant CLI Ops skill?

Run npx skillmds@latest add zenobi-us/home-assistant-cli-ops in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Home Assistant CLI Ops safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Home Assistant CLI Ops?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Home Assistant CLI Ops free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Home Assistant CLI Ops?

zenobi-us (@zenobi-us) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Home Assistant CLI Ops by zenobi-us

Name: Home Assistant CLI Ops
Author: zenobi-us

Home Assistant CLI Ops

Operate Home Assistant remotely with hass-cli, when inspecting states/entities, calling services, watching events, or using raw API endpoints, resulting in fast read-first runtime operations from the terminal.

zenobi-us d164967 2 files · 4.2 KB Updated Sep 17, 2026

File contents

Home Assistant CLI Ops (`hass-cli`)

Use this skill for direct remote operations against a Home Assistant instance through hass-cli.

This skill is for interactive CLI operations.

For scripted/bulk plan→apply→rollback workflows, use: homeassistant-ops/SKILL.md
For automation and YAML design decisions, use: home-assistant-best-practices/SKILL.md
If task scope is unclear, route first with: homeassistant-router/SKILL.md

When to Use

Use when you need to:

Inspect runtime state quickly (state, entity, device, area)
Trigger or toggle behavior immediately (service call, state toggle)
Watch events live for debugging (event watch)
Use API endpoints not covered by high-level commands (raw get/post/ws)

Do not use this as your only tool for high-risk bulk refactors. Switch to homeassistant-ops for that.

Setup

Prefer environment variables over command-line secrets:

export HASS_SERVER="http://homeassistant.local:8123"
export HASS_TOKEN="<long-lived-access-token>"

Your local alias is expected:

hass-cli --help

Default Safety Workflow (read -> scope -> write -> verify)

Read first: info, config release, state list, entity list
Scope tightly: filter by entity/service/domain before changing anything
Apply one change: one service call / one state toggle / one assignment
Verify outcome: state get + event watch <event_type> if needed
Only then batch: repeat in small groups after first success

Command Reference

Use the focused command guide in:

references/command-cheatsheet.md

This keeps SKILL.md short while preserving copy-paste-ready commands for common tasks.

Common Mistakes

Passing tokens directly via --token in shell history.
Writing first, reading later.
Running broad --match operations without previewing list output.
Treating state edit as persistent config management (it is runtime state manipulation).

Command Discovery

When unsure, inspect command tree first:

hass-cli --help
hass-cli <command> --help
hass-cli <command> <subcommand> --help

Related Skills

ai/files/packages/platform/skills/homeassistant/homeassistant-ops/SKILL.md
ai/files/packages/platform/skills/homeassistant/home-assistant-best-practices/SKILL.md

Upstream Sources

home-assistant-cli README.rst: https://github.com/home-assistant-ecosystem/home-assistant-cli/blob/dev/README.rst
home-assistant-cli repository: https://github.com/home-assistant-ecosystem/home-assistant-cli

---name: home-assistant-cli-opsdescription: Operate Home Assistant remotely with hass-cli, when inspecting states/entities, calling services, watching events, or using raw API endpoints, resulting in fast read-first runtime operations from the terminal.---# Home Assistant CLI Ops (`hass-cli`)Use this skill for direct remote operations against a Home Assistant instance through `hass-cli`.This skill is for interactive CLI operations.- For scripted/bulk plan→apply→rollback workflows, use: `homeassistant-ops/SKILL.md`- For automation and YAML design decisions, use: `home-assistant-best-practices/SKILL.md`- If task scope is unclear, route first with: `homeassistant-router/SKILL.md`## When to UseUse when you need to:- Inspect runtime state quickly (`state`, `entity`, `device`, `area`)- Trigger or toggle behavior immediately (`service call`, `state toggle`)- Watch events live for debugging (`event watch`)- Use API endpoints not covered by high-level commands (`raw get/post/ws`)Do not use this as your only tool for high-risk bulk refactors. Switch to `homeassistant-ops` for that.## SetupPrefer environment variables over command-line secrets:```bashexport HASS_SERVER="http://homeassistant.local:8123"export HASS_TOKEN="<long-lived-access-token>"```Your local alias is expected:```bashhass-cli --help```## Default Safety Workflow (read -> scope -> write -> verify)1. **Read first**: `info`, `config release`, `state list`, `entity list`2. **Scope tightly**: filter by entity/service/domain before changing anything3. **Apply one change**: one service call / one state toggle / one assignment4. **Verify outcome**: `state get` + `event watch <event_type>` if needed5. **Only then batch**: repeat in small groups after first success## Command ReferenceUse the focused command guide in:- `references/command-cheatsheet.md`This keeps `SKILL.md` short while preserving copy-paste-ready commands for common tasks.## Common Mistakes- Passing tokens directly via `--token` in shell history.- Writing first, reading later.- Running broad `--match` operations without previewing list output.- Treating `state edit` as persistent config management (it is runtime state manipulation).## Command DiscoveryWhen unsure, inspect command tree first:```bashhass-cli --helphass-cli <command> --helphass-cli <command> <subcommand> --help```## Related Skills- `ai/files/packages/platform/skills/homeassistant/homeassistant-ops/SKILL.md`- `ai/files/packages/platform/skills/homeassistant/home-assistant-best-practices/SKILL.md`## Upstream Sources- home-assistant-cli README.rst: https://github.com/home-assistant-ecosystem/home-assistant-cli/blob/dev/README.rst- home-assistant-cli repository: https://github.com/home-assistant-ecosystem/home-assistant-cli

Frequently asked questions