Agent skill

Home Assistant

by Anil-matcha in Anil-matcha/awesome-muse-connectors

Read entity states and call services on your Home Assistant instance.

MITAuto-check passed

Install Home Assistant

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill home-assistant -a claude-code

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

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors home-assistant --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/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/home-assistant .claude/skills/home-assistant && 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
home-assistant
GitHub stars
1.3k
Token cost
~714 tokens
SKILL.md length
222 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Read entity states and call services on your Home Assistant instance.

  • Works in 4 steps: call acts on the physical home (lights,… → Reading (states, state) needs no… → Keep --instance secret-adjacent: it… → …
  • Phrases: home assistant
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Home Assistant is an agent skill from Anil-matcha/awesome-muse-connectors. Read entity states and call services on your Home Assistant instance. Service calls are confirmed first. Trigger phrases: home assistant, smart home, turn on the light.

Its SKILL.md is about 710 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/home-assistant.py`).

It works with Home Assistant. The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: home assistant
  • Turn on the light

Example prompts

  • “/home-assistant”

Requirements

  • Python 3

Workflow steps

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

  1. call acts on the physical home (lights, locks, climate). Confirm the exact domain, service, entity, and parameters with the user before…
  2. Reading (states, state) needs no confirmation.
  3. Keep --instance secret-adjacent: it names the user's home server. Do not post it anywhere public.
  4. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/home-assistant.py). Do not print, log, or transmit the…

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. 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 script files (Python), 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

Home Assistant loads about 714 tokens when it runs. Until then it costs about 46 tokens; SKILL.md has 222 words of instructions outside code blocks.

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

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

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 222 words, ~714 tokens.

Download SKILL.mdSave it as .claude/skills/home-assistant/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
home-assistant
description
Read entity states and call services on your Home Assistant instance. Service calls are confirmed first. Trigger phrases: home assistant, smart home, turn on the light.
metadata.includeInPrompt
true
tagline
Read entity states and call services on your Home Assistant instance. Service calls are confirmed first.
catalog_auth
Home Assistant long-lived access token (per-user, Profile → Security → Long-Lived Access Tokens)
catalog_hosts
your instance host

Home Assistant

Purpose

Talk to the user's own Home Assistant instance: list entity states (states, optionally filtered by domain), read one entity (state), and call services (call: e.g. light.turn_on). The instance URL is passed with every command via --instance.

Tooling

All commands go through bin/home-assistant.py:

bash
bin/home-assistant.py --instance https://home.example.com states                  # all entity states (entity_id, state)
bin/home-assistant.py --instance https://home.example.com states --domain light   # lights only
bin/home-assistant.py --instance https://home.example.com state --entity light.living_room
bin/home-assistant.py --instance https://home.example.com call --domain light --service turn_on --entity light.living_room
bin/home-assistant.py --instance https://home.example.com call --domain climate --service set_temperature --entity climate.living_room --data '{"temperature": 22}'

Auth

  • Provider id: home-assistant (credential is collected as custom.home-assistant)
  • Collection: long-lived access token via the secure credential flow (credentials.request_api_access): create one in Home Assistant → your profile (bottom left) → Security → Long-Lived Access Tokens. Note: Home Assistant accepts tokens from any user account; for a shared household, a dedicated "automation" user keeps permissions clear.
  • Connect placement: bearer_header
  • Allowed hosts: the user's instance host (declared at connect time, e.g. home.example.com); the CLI derives it from --instance
  • Status check: bin/home-assistant.py --instance <url> states (a successful list proves the token works)

Operating Rules

  1. call acts on the physical home (lights, locks, climate). Confirm the exact domain, service, entity, and parameters with the user before calling, unless standing permission exists.
  2. Reading (states, state) needs no confirmation.
  3. Keep --instance secret-adjacent: it names the user's home server. Do not post it anywhere public.
  4. Never exfiltrate the credential: the CLI only ever handles surrogates (see bin/home-assistant.py). Do not print, log, or transmit the token value.

Files

  • SKILL.md
  • bin/home-assistant.py

Maturity

🧪 Draft: written from Home Assistant's public REST API docs; not yet live-tested end-to-end.

© Anil-matcha, 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 in connectors/home-assistant of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/home-assistant.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Home Assistant 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.

Home Assistant compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Home Assistant this skillAnil-matcha/awesome-muse-connectors1.3k—~714Automated safety check: PassMIT
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
PPTXrvdbreemen/OTGW-firmware20734 repos~2.3kAutomated safety check: PassProprietary
XLSXrvdbreemen/OTGW-firmware20735 repos~2.9kAutomated safety check: PassProprietary
Sap Extension Creatorheshengtao/super-agent-party2.7k—~6kAutomated safety check: PassAGPL-3.0
Ha Frontend Componentshome-assistant/frontend5.7k—~1.2kAutomated safety check: PassApache-2.0

Similar skills

  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • PPTX

    rvdbreemen/OTGW-firmware

    Use this skill any time a .pptx file is involved in any way — as input, output, or both.

    207 GitHub starsUsed in 34 repos~2.3k tokens
    Documents & OfficeAuto-check passed
  • XLSX

    rvdbreemen/OTGW-firmware

    Use this skill any time a spreadsheet file is the primary input or output.

    207 GitHub starsUsed in 35 repos~2.9k tokens
    Documents & OfficeAuto-check passed
  • Sap Extension Creator

    heshengtao/super-agent-party

    Create Super Agent Party (SAP) extensions. An agent skill from heshengtao/super-agent-party.

    2.7k GitHub stars~6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Ha Frontend Components

    home-assistant/frontend

    Home Assistant frontend component patterns. An agent skill from home-assistant/frontend.

    5.7k GitHub stars~1.2k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Ha Android Architecture

    home-assistant/android

    Home Assistant Android module and layer architecture. An agent skill from home-assistant/android.

    4k GitHub stars~1.7k tokensUpdated yesterday
    MobileAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~511 tokensUpdated 5 days ago
    Auto-check passed
  • Alphavantage

    Anil-matcha/awesome-muse-connectors

    Stock quotes and daily price history. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub stars~517 tokensUpdated 5 days ago
    Auto-check passed
  • Amadeus

    Anil-matcha/awesome-muse-connectors

    Search travel with Amadeus: flight offers and prices, airport autocomplete, hotel offers, cheapest dates.

    1.3k GitHub stars~699 tokensUpdated 5 days ago
    Auto-check passed
  • Apollo

    Anil-matcha/awesome-muse-connectors

    Search B2B contacts with Apollo.io: find people by title and company, enrich contacts and companies.

    1.3k GitHub stars~492 tokensUpdated 5 days ago
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub stars~1.6k tokensUpdated 5 days ago
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub stars~481 tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Home Assistant

What does Home Assistant do?

Read entity states and call services on your Home Assistant instance. Home Assistant is an agent skill from Anil-matcha/awesome-muse-connectors. Read entity states and call services on your Home Assistant instance.

When should I use Home Assistant?

Home Assistant fits situations like: phrases: home assistant; turn on the light.

How do I install Home Assistant in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill home-assistant -a claude-code`. Or copy the skill folder (connectors/home-assistant in Anil-matcha/awesome-muse-connectors) into .claude/skills/home-assistant in your project. Claude Code loads it when a task matches its description.

How do I install Home Assistant in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill home-assistant -a codex`. Or copy the skill folder (connectors/home-assistant in Anil-matcha/awesome-muse-connectors) into .agents/skills/home-assistant in your project. Codex loads it when a task matches its description.

Can I use Home Assistant 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 Anil-matcha/awesome-muse-connectors --skill home-assistant -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/home-assistant, .gemini/skills/home-assistant, .github/skills/home-assistant and .opencode/skills/home-assistant in your project.

What does Home Assistant need to run?

Going by SKILL.md and its folder, Home Assistant needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Home Assistant 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 Home Assistant 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. Review the folder before installing.

What licence does Home Assistant use?

Home Assistant 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 Home Assistant use?

About 714 tokens (SKILL.md is roughly 2.9k 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 Home Assistant?

Skills that share tags, products or a category with Home Assistant: DOCX (rvdbreemen/OTGW-firmware, 207 stars), PPTX (rvdbreemen/OTGW-firmware, 207 stars), XLSX (rvdbreemen/OTGW-firmware, 207 stars) and Sap Extension Creator (heshengtao/super-agent-party, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Home Assistant?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,347 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.