home-assistant-skills
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/homeassistant-ai-skills)HTML
<a href="/listings/homeassistant-ai-skills"><img src="/api/listings/homeassistant-ai-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Agent Skills installer
Requires [Node.js 22.20+](https://nodejs.org/).
npx skills add homeassistant-ai/skills
Works with AI coding agents that support the [Agent Skills standard](https://agentskills.io): Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and 70+ others. It installs into the current project; add `-g` to install it for all projects. To update: `npx skills update`
Claude Code plugin
Claude Code also accepts the installer above, which places the skill files in your `.claude/skills/` directory. The commands below install it as a plugin instead, kept in Claude Code's own plugin cache.
Run each command separately inside Claude Code:
/plugin marketplace add homeassistant-ai/skills
/plugin install home-assistant-skills@home-assistant-skills
Run `/reload-plugins` or restart Claude Code for the skill to take effect.
Auto-update is off by default for third-party marketplaces. To turn it on, run `/plugin`, open **Marketplaces**, choose `home-assistant-skills`, and select **Enable auto-update**. To update by hand instead, run `/plugin`, open **Marketplaces**, choose `home-assistant-skills`, and select **Update marketplace**, then run `/reload-plugins`. From a shell, run these, then `/reload-plugins` or restart Claude Code:
claude plugin marketplace update home-assistant-skills claude plugin update home-assistant-skills@home-assistant-skills
Claude Desktop / claude.ai
Both apps share the same Customize UI, reached via the left sidebar (Claude Desktop) or [claude.ai/customize](https://claude.ai/customize) (browser).
1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills) 2. Customize → Plugins → Add → Add marketplace → Add from a repository 3. Select or enter `homeassistant-ai/skills` (or the full URL, `https://github.com/homeassistant-ai/skills`) → Sync
This installs the skill as a plugin synced from this repo — no download or zip needed. **Sync automatically** is on by default, so later updates arrive on their own. To pull an update at once, open **Add → Manage marketplaces**, then the marketplace's menu → **Check for updates**.
<details> <summary>Alternative: upload the skill manually as a zip</summary>
1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills) 2. Download or clone this repository 3. Zip the skill folder: `cd skills && zip -r home-assistant-best-practices.zip home-assistant-best-practices/` 4. Customize → Skills → Add → Upload skill
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 18 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "home-assistant-skills",
- "owner": {
- "name": "homeassistant-ai",
- "email": "homeassistant-mcp@qc-h.net"
- },
- "metadata": {
- "description": "Agent skills for Home Assistant: best practices for automations, helpers, templates, scenes, blueprints, device control, dashboards, AppDaemon, and backups",
- "version": "0.56.0"
- },
- "plugins": [
- {
- "name": "home-assistant-skills",
- "description": "Best practices for Home Assistant automations, helpers, scripts, scenes, blueprints, device control, dashboards, AppDaemon apps, and backups",
- "source": "./"
- }
- ]
- }
README.md · README · 123 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Home Assistant Agent Skills
- [](LICENSE)
- [](https://agentskills.io)
- An **Agent Skill** is a portable Markdown knowledge pack that teaches AI coding agents best practices for a specific technology. This repository provides one for Home Assistant, following the open [Agent Skills standard](https://agentskills.io/specification). Install it and your agent applies Home Assistant best practices in every session.
- ## Included Skill
- **[home-assistant-best-practices](skills/home-assistant-best-practices/)** — a decision workflow and anti-pattern table in `SKILL.md`, backed by reference files the agent loads on demand. It covers:
- - **Authoring** — native triggers and conditions over templates, helper selection, automation modes, device control and button/remote patterns, scenes, blueprints
- - **Dashboards** — layout, views, cards, badges, custom cards
- - **Operations** — YAML-only integration management, backups and recovery, safe refactoring of existing config
- - **AppDaemon** — when to use it over native HA, and how to structure apps
- Agents make a predictable set of mistakes with Home Assistant config — Jinja templates where a native trigger, condition, or helper exists, `device_id` where `entity_id` belongs, `mode: single` on a motion light, renames that silently break dashboards and scripts — and the anti-pattern table names each one with its fix. A typical entry:
- ```yaml
- # Without the skill: a template condition. HA checks only the Jinja syntax when the automation loads
- condition: template
- value_template: "{{ states('sensor.living_room_temperature') | float > 25 }}"
- # With the skill: a native condition. HA checks every key, the entity ID format and the threshold when it loads
- condition: numeric_state
- entity_id: sensor.living_room_temperature
- above: 25
- ```
- See [Skill Contents](#skill-contents) for the file-by-file map.
- ## Installation
- ### Agent Skills installer
- Requires [Node.js 22.20+](https://nodejs.org/).
- ```bash
- npx skills add homeassistant-ai/skills
- ```
- Works with AI coding agents that support the [Agent Skills standard](https://agentskills.io): Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and 70+ others. It installs into the current project; add `-g` to install it for all projects. To update: `npx skills update`
- ### Claude Code plugin
- Claude Code also accepts the installer above, which places the skill files in your `.claude/skills/` directory. The commands below install it as a plugin instead, kept in Claude Code's own plugin cache.
- Run each command separately inside Claude Code:
- ```
- /plugin marketplace add homeassistant-ai/skills
- ```
- ```
- /plugin install home-assistant-skills@home-assistant-skills
- ```
- Run `/reload-plugins` or restart Claude Code for the skill to take effect.
- Auto-update is off by default for third-party marketplaces. To turn it on, run `/plugin`, open **Marketplaces**, choose `home-assistant-skills`, and select **Enable auto-update**. To update by hand instead, run `/plugin`, open **Marketplaces**, choose `home-assistant-skills`, and select **Update marketplace**, then run `/reload-plugins`. From a shell, run these, then `/reload-plugins` or restart Claude Code:
- ```bash
- claude plugin marketplace update home-assistant-skills
- claude plugin update home-assistant-skills@home-assistant-skills
- ```
- ### Claude Desktop / claude.ai
- Both apps share the same Customize UI, reached via the left sidebar (Claude Desktop) or [claude.ai/customize](https://claude.ai/customize) (browser).
- 1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills)
- 2. Customize → Plugins → Add → Add marketplace → Add from a repository
- 3. Select or enter `homeassistant-ai/skills` (or the full URL, `https://github.com/homeassistant-ai/skills`) → Sync
- This installs the skill as a plugin synced from this repo — no download or zip needed. **Sync automatically** is on by default, so later updates arrive on their own. To pull an update at once, open **Add → Manage marketplaces**, then the marketplace's menu → **Check for updates**.
- <details>
- <summary>Alternative: upload the skill manually as a zip</summary>
- 1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills)
- 2. Download or clone this repository
- 3. Zip the skill folder: `cd skills && zip -r home-assistant-best-practices.zip home-assistant-best-practices/`
- 4. Customize → Skills → Add → Upload skill
- </details>
- ## Usage
- Once installed, the skill loads on its own whenever the agent works on automations, scripts, scenes, helpers, dashboards, blueprints, or backups — it needs no explicit invocation. Try:
- > Create an automation that turns on the hallway light when motion is detected and turns it off five minutes after the motion stops.
- ## Skill Contents
- The `home-assistant-best-practices` skill includes:
- | File | Purpose |
- |------|---------|
- | [`SKILL.md`](skills/home-assistant-best-practices/SKILL.md) | Decision workflow, anti-pattern table, and pointers to the reference files below |
- | [`references/safe-refactoring.md`](skills/home-assistant-best-practices/references/safe-refactoring.md) | Safe workflow for renaming entities and their display names, replacing helpers, restructuring automations; display-name override, config-entry, and storage-dashboard blind spots |
- | [`references/triggers-and-conditions.md`](skills/home-assistant-best-practices/references/triggers-and-conditions.md) | Purpose-specific and native triggers/conditions, `for:` durations, trigger IDs |
- | [`references/automation-actions.md`](skills/home-assistant-best-practices/references/automation-actions.md) | Waits, variables, automation modes, control flow (choose, repeat, parallel), error handling (`continue_on_error`, admin-only actions), disabling automations, measuring elapsed time via `last_triggered`, Mobile App `notify` action vs entity, trace retention |
- | [`references/helper-selection.md`](skills/home-assistant-best-practices/references/helper-selection.md) | Built-in helpers vs template sensors (with decision matrix) |
- | [`references/template-guidelines.md`](skills/home-assistant-best-practices/references/template-guidelines.md) | When to use templates, when to avoid them, template sensor best practices, reusable `custom_templates` macros |
- | [`references/yaml-only-integrations.md`](skills/home-assistant-best-practices/references/yaml-only-integrations.md) | YAML-only integration types, post-edit actions (reload vs restart) |
- | [`references/device-control.md`](skills/home-assistant-best-practices/references/device-control.md) | Actions and targeting, entity_id vs device_id, buttons and remotes, domain-specific patterns |
- | [`references/scenes.md`](skills/home-assistant-best-practices/references/scenes.md) | Scene authoring: config shape, snapshot/restore, snapshot-vs-script distinction |
- | [`references/dashboard-guide.md`](skills/home-assistant-best-practices/references/dashboard-guide.md) | Dashboard layout, view types, strategies, sections, cards, badges, custom cards, CSS styling, HACS / Marketplace |
- | [`references/dashboard-cards.md`](skills/home-assistant-best-practices/references/dashboard-cards.md) | Built-in card type lookup (core, energy, legacy), where to read a card's fields, entities-card attribute rows |
- | [`references/domain-docs.md`](skills/home-assistant-best-practices/references/domain-docs.md) | Integration and domain documentation (actions, entity attributes); doc pages for specific triggers, conditions, and actions |
- | [`references/examples.yaml`](skills/home-assistant-best-practices/references/examples.yaml) | Compound examples combining multiple best practices |
- | [`references/appdaemon.md`](skills/home-assistant-best-practices/references/appdaemon.md) | AppDaemon apps: when to use vs. native HA, app structure, actions, scheduling, error handling, safe refactoring impact |
- | [`references/blueprint-guide.md`](skills/home-assistant-best-practices/references/blueprint-guide.md) | Blueprint authoring: metadata & `source_url`, inputs & selectors, `target` vs `entity`, defaults, `!input` templating, versioning |
- | [`references/backups.md`](skills/home-assistant-best-practices/references/backups.md) | Full instance backups vs rolling one object back, when to offer a backup before an operation, what an archive contains, encryption keys, restore verification, backup deletion, why a git config repo does not replace a full backup |
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on writing and submitting skills.
- Skill misled your agent? Open an issue with the [Report Bad Skill Advice](https://github.com/homeassistant-ai/skills/issues/new?template=skill-rca.md) template and let the agent fill it in — it holds the context to trace the failure to its source in the skill.
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.