Skip to content
Back to search

home-assistant-skills

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/homeassistant-ai-skills/badge.svg)](/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)

  1. {
  2. "name": "home-assistant-skills",
  3. "owner": {
  4. "name": "homeassistant-ai",
  5. "email": "homeassistant-mcp@qc-h.net"
  6. },
  7. "metadata": {
  8. "description": "Agent skills for Home Assistant: best practices for automations, helpers, templates, scenes, blueprints, device control, dashboards, AppDaemon, and backups",
  9. "version": "0.56.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "home-assistant-skills",
  14. "description": "Best practices for Home Assistant automations, helpers, scripts, scenes, blueprints, device control, dashboards, AppDaemon apps, and backups",
  15. "source": "./"
  16. }
  17. ]
  18. }
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)

  1. # Home Assistant Agent Skills
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  3. [![Agent Skills](https://img.shields.io/badge/Agent_Skills-agentskills.io-blue)](https://agentskills.io)
  4. 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.
  5. ## Included Skill
  6. **[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:
  7. - **Authoring** — native triggers and conditions over templates, helper selection, automation modes, device control and button/remote patterns, scenes, blueprints
  8. - **Dashboards** — layout, views, cards, badges, custom cards
  9. - **Operations** — YAML-only integration management, backups and recovery, safe refactoring of existing config
  10. - **AppDaemon** — when to use it over native HA, and how to structure apps
  11. 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:
  12. ```yaml
  13. # Without the skill: a template condition. HA checks only the Jinja syntax when the automation loads
  14. condition: template
  15. value_template: "{{ states('sensor.living_room_temperature') | float > 25 }}"
  16. # With the skill: a native condition. HA checks every key, the entity ID format and the threshold when it loads
  17. condition: numeric_state
  18. entity_id: sensor.living_room_temperature
  19. above: 25
  20. ```
  21. See [Skill Contents](#skill-contents) for the file-by-file map.
  22. ## Installation
  23. ### Agent Skills installer
  24. Requires [Node.js 22.20+](https://nodejs.org/).
  25. ```bash
  26. npx skills add homeassistant-ai/skills
  27. ```
  28. 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`
  29. ### Claude Code plugin
  30. 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.
  31. Run each command separately inside Claude Code:
  32. ```
  33. /plugin marketplace add homeassistant-ai/skills
  34. ```
  35. ```
  36. /plugin install home-assistant-skills@home-assistant-skills
  37. ```
  38. Run `/reload-plugins` or restart Claude Code for the skill to take effect.
  39. 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:
  40. ```bash
  41. claude plugin marketplace update home-assistant-skills
  42. claude plugin update home-assistant-skills@home-assistant-skills
  43. ```
  44. ### Claude Desktop / claude.ai
  45. Both apps share the same Customize UI, reached via the left sidebar (Claude Desktop) or [claude.ai/customize](https://claude.ai/customize) (browser).
  46. 1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills)
  47. 2. Customize → Plugins → Add → Add marketplace → Add from a repository
  48. 3. Select or enter `homeassistant-ai/skills` (or the full URL, `https://github.com/homeassistant-ai/skills`) → Sync
  49. 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**.
  50. <details>
  51. <summary>Alternative: upload the skill manually as a zip</summary>
  52. 1. Enable code execution: Settings → Capabilities → turn on **Cloud code execution and file creation** (required for skills)
  53. 2. Download or clone this repository
  54. 3. Zip the skill folder: `cd skills && zip -r home-assistant-best-practices.zip home-assistant-best-practices/`
  55. 4. Customize → Skills → Add → Upload skill
  56. </details>
  57. ## Usage
  58. 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:
  59. > Create an automation that turns on the hallway light when motion is detected and turns it off five minutes after the motion stops.
  60. ## Skill Contents
  61. The `home-assistant-best-practices` skill includes:
  62. | File | Purpose |
  63. |------|---------|
  64. | [`SKILL.md`](skills/home-assistant-best-practices/SKILL.md) | Decision workflow, anti-pattern table, and pointers to the reference files below |
  65. | [`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 |
  66. | [`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 |
  67. | [`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 |
  68. | [`references/helper-selection.md`](skills/home-assistant-best-practices/references/helper-selection.md) | Built-in helpers vs template sensors (with decision matrix) |
  69. | [`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 |
  70. | [`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) |
  71. | [`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 |
  72. | [`references/scenes.md`](skills/home-assistant-best-practices/references/scenes.md) | Scene authoring: config shape, snapshot/restore, snapshot-vs-script distinction |
  73. | [`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 |
  74. | [`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 |
  75. | [`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 |
  76. | [`references/examples.yaml`](skills/home-assistant-best-practices/references/examples.yaml) | Compound examples combining multiple best practices |
  77. | [`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 |
  78. | [`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 |
  79. | [`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 |
  80. ## Contributing
  81. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on writing and submitting skills.
  82. 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.
  83. ## License
  84. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.