Skip to content
Back to search

claude-skill-homeassistant

MarketplaceWorks with Claude CodeGitHub

Marketplace for the Home Assistant Manager Claude Code skill

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/komal-skynet-claude-skill-homeassistant/badge.svg)](/listings/komal-skynet-claude-skill-homeassistant)

HTML

<a href="/listings/komal-skynet-claude-skill-homeassistant"><img src="/api/listings/komal-skynet-claude-skill-homeassistant/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.

Prerequisites

1. **Claude Code** installed and configured 2. **Home Assistant** instance with: - SSH access enabled - Git repository connected to `/config` directory 3. **Local tools**: - `hass-cli` installed (`pipx install homeassistant-cli`) - SSH key authentication configured - Environment variables set: `HASS_SERVER`, `HASS_TOKEN`

Install the Skill

Option 1: Claude Code plugin marketplace (recommended)

This repo is also a self-hosted plugin marketplace, so you can install it with two slash commands — no manual cloning required:

/plugin marketplace add komal-SkyNET/claude-skill-homeassistant
/plugin install home-assistant-manager@claude-skill-homeassistant

Run these from anywhere — they install the plugin (and its skill) globally for Claude Code, so it's available whenever you open a Home Assistant config repo. Update later with `/plugin marketplace update claude-skill-homeassistant` followed by `/plugin update home-assistant-manager`.

Option 2: Clone into your Home Assistant config repository

cd /path/to/your/homeassistant/config
mkdir -p .claude/skills
cd .claude/skills
git clone git@github.com:komal-SkyNET/claude-skill-homeassistant.git home-assistant-manager-repo
ln -s home-assistant-manager-repo/skills/home-assistant-manager home-assistant-manager

Option 3: Download and extract

cd /path/to/your/homeassistant/config
mkdir -p .claude/skills/home-assistant-manager
cd .claude/skills/home-assistant-manager
curl -L https://github.com/komal-SkyNET/claude-skill-homeassistant/archive/main.tar.gz | tar xz --strip-components=2 claude-skill-homeassistant-main/skills/home-assistant-manager

Verify Installation

After installing via the plugin marketplace, run `/plugin` to confirm `home-assistant-manager` is listed and enabled. With the manual options, the skill should appear when you start Claude Code in your Home Assistant repository. Either way, Claude will automatically load the skill and apply the expertise.

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 · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "claude-skill-homeassistant",
  4. "description": "Marketplace for the Home Assistant Manager Claude Code skill",
  5. "owner": {
  6. "name": "komal-SkyNET"
  7. },
  8. "plugins": [
  9. {
  10. "name": "home-assistant-manager",
  11. "source": "./",
  12. "description": "Expert-level Home Assistant configuration management: deploy workflows, SSH/hass-cli access, automation verification, and Lovelace dashboard development",
  13. "category": "smart-home",
  14. "homepage": "https://github.com/komal-SkyNET/claude-skill-homeassistant"
  15. }
  16. ]
  17. }
README.md · README · 404 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 Manager - Claude Code Skill
  2. > Expert-level Home Assistant configuration management with efficient deployment workflows, remote CLI access, automation verification, and comprehensive Lovelace dashboard development.
  3. [![Claude Code](https://img.shields.io/badge/Claude-Code-8A2BE2)](https://github.com/anthropics/claude-code)
  4. [![Home Assistant](https://img.shields.io/badge/Home%20Assistant-Compatible-41BDF5)](https://www.home-assistant.io/)
  5. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  6. ![Tablet Dashboard Example](skills/home-assistant-manager/dashboard.png)
  7. *Example tablet-optimized dashboard built using this skill - touch-friendly controls, color-coded status, and responsive grid layout*
  8. ## 🎬 See It In Action
  9. ### Quick Skill Check
  10. Verify Claude can see and use this skill:
  11. https://github.com/user-attachments/assets/a215df83-ce84-4ed2-bb93-f3a3ee0c43e8
  12. *Shows Claude recognizing the skill and loading Home Assistant expertise*
  13. ### Full Workflow Demo
  14. Watch the complete workflow in action - end to end (3x speed):
  15. https://github.com/user-attachments/assets/eab53b18-ae2b-4d43-b1e4-e45bf9357099
  16. *Complete automation development cycle including deployment, testing, log analysis, and git workflow*
  17. ## 🚀 What This Skill Does
  18. This Claude Code skill transforms Claude into a **Home Assistant expert** that helps you:
  19. ### Configuration Management
  20. - **Rapid Development Workflow**: Deploy changes via `scp` for instant testing, commit to git when stable
  21. - **Smart Reload vs Restart**: Automatically determines whether to reload or restart based on change type
  22. - **Configuration Validation**: Always validates before applying changes to prevent downtime
  23. - **Remote CLI Access**: Seamlessly manages HA instances via SSH and `hass-cli`
  24. ### Automation Development
  25. - **Modern Syntax by Default**: Writes current (2024.10+) automation YAML — `triggers:/conditions:/actions:`, `action:` not `service:` — instead of the deprecated syntax LLMs tend to emit
  26. - **Complete Verification Protocol**: Automatically tests automations by triggering manually and checking logs and traces — including the `automation.trigger`-skips-conditions gotcha
  27. - **Blueprints & Modes**: Knows blueprint structure/usage and when an automation needs `mode: restart` vs `single`
  28. - **Error Detection**: Identifies template errors, type mismatches, and execution failures
  29. - **Log Analysis Patterns**: Knows what success and error indicators to look for
  30. - **Iterative Fix Workflow**: Guides through debugging and re-testing cycles
  31. ### Lovelace Dashboard Development
  32. - **Tablet Optimization**: Creates touch-friendly dashboards optimized for specific screen sizes (7", 11", 13")
  33. - **Card Type Expertise**: Knows when to use Mushroom cards, Tile cards, Panel vs Sections views
  34. - **Template Patterns**: Provides ready-to-use Jinja2 templates for common use cases:
  35. - Door/window counting with color coding
  36. - Conditional display based on time/state
  37. - Multi-condition status indicators
  38. - **Common Pitfall Solutions**: Solves dashboard registration, auto-entities failures, template type errors
  39. - **Real-World Examples**: Includes working examples from production tablet dashboards
  40. ### Workflow Optimization
  41. - **Git + scp Hybrid**: Uses git for version control, scp for rapid iteration
  42. - **No Restart for Dashboards**: Deploys dashboard changes with just browser refresh
  43. - **Context7 Integration**: Leverages official HA documentation via MCP when available
  44. - **Deployment Decision Tree**: Guides through the optimal workflow based on change type
  45. ## 🆚 How Is This Different From an HA MCP Server?
  46. They solve different problems, and they compose:
  47. - **MCP servers** (the official `mcp_server` integration or community `ha-mcp`) give Claude **live tools** — read entity state, call services, control devices. They don't teach Claude *how to work on your config*.
  48. - **This skill** encodes the **procedure and judgment**: the git/scp deploy pipeline, reload-vs-restart decisions, validate-before-restart discipline, the verify-from-logs-and-traces loop, template type-safety rules, dashboard storage-cache gotchas, and modern automation syntax.
  49. Without the skill, an MCP-equipped Claude can flip your lights but will still happily restart HA on an unvalidated config or write deprecated automation YAML. Without MCP, the skill falls back to SSH/`hass-cli`. Together is best: the skill explicitly prefers MCP tools for live state and service calls when available.
  50. ## 📦 Installation
  51. ### Prerequisites
  52. 1. **Claude Code** installed and configured
  53. 2. **Home Assistant** instance with:
  54. - SSH access enabled
  55. - Git repository connected to `/config` directory
  56. 3. **Local tools**:
  57. - `hass-cli` installed (`pipx install homeassistant-cli`)
  58. - SSH key authentication configured
  59. - Environment variables set: `HASS_SERVER`, `HASS_TOKEN`
  60. ### Install the Skill
  61. #### Option 1: Claude Code plugin marketplace (recommended)
  62. This repo is also a self-hosted plugin marketplace, so you can install it with two slash commands — no manual cloning required:
  63. ```
  64. /plugin marketplace add komal-SkyNET/claude-skill-homeassistant
  65. /plugin install home-assistant-manager@claude-skill-homeassistant
  66. ```
  67. Run these from anywhere — they install the plugin (and its skill) globally for Claude Code, so it's available whenever you open a Home Assistant config repo. Update later with `/plugin marketplace update claude-skill-homeassistant` followed by `/plugin update home-assistant-manager`.
  68. #### Option 2: Clone into your Home Assistant config repository
  69. ```bash
  70. cd /path/to/your/homeassistant/config
  71. mkdir -p .claude/skills
  72. cd .claude/skills
  73. git clone git@github.com:komal-SkyNET/claude-skill-homeassistant.git home-assistant-manager-repo
  74. ln -s home-assistant-manager-repo/skills/home-assistant-manager home-assistant-manager
  75. ```
  76. #### Option 3: Download and extract
  77. ```bash
  78. cd /path/to/your/homeassistant/config
  79. mkdir -p .claude/skills/home-assistant-manager
  80. cd .claude/skills/home-assistant-manager
  81. curl -L https://github.com/komal-SkyNET/claude-skill-homeassistant/archive/main.tar.gz | tar xz --strip-components=2 claude-skill-homeassistant-main/skills/home-assistant-manager
  82. ```
  83. ### Verify Installation
  84. After installing via the plugin marketplace, run `/plugin` to confirm `home-assistant-manager` is listed and enabled. With the manual options, the skill should appear when you start Claude Code in your Home Assistant repository. Either way, Claude will automatically load the skill and apply the expertise.
  85. ## 🎯 Usage Examples
  86. ### Example 1: Create a New Automation
  87. ```
  88. User: "Create an automation that sends a notification when the front door
  89. is left open for more than 5 minutes"
  90. Claude: [Uses skill to]:
  91. 1. Create automation YAML with proper syntax
  92. 2. Deploy via scp for testing
  93. 3. Reload automations (no restart needed)
  94. 4. Manually trigger to test
  95. 5. Check logs for execution
  96. 6. Verify notification received
  97. 7. Commit to git when working
  98. ```
  99. ### Example 2: Build a Tablet Dashboard
  100. ```
  101. User: "Create a dashboard for my 11-inch tablet in the living room
  102. with lights, thermostat, and door status"
  103. Claude: [Uses skill to]:
  104. 1. Create new dashboard file in .storage/
  105. 2. Register in lovelace_dashboards
  106. 3. Use 3-column grid layout (optimal for 11")
  107. 4. Add Mushroom cards for touch-friendly controls
  108. 5. Create template card with door counting
  109. 6. Deploy via scp for instant preview
  110. 7. Iterate on layout based on feedback
  111. 8. Commit when finalized
  112. ```
  113. ### Example 3: Debug a Template Error
  114. ```
  115. User: "My automation has a TypeError about comparing str and int"
  116. Claude: [Uses skill to]:
  117. 1. Check logs for exact error message
  118. 2. Identify template needs | int filter
  119. 3. Fix the template syntax
  120. 4. Deploy via scp
  121. 5. Trigger manually to verify
  122. 6. Check logs confirm no errors
  123. 7. Commit the fix
  124. ```
  125. ## 🏗️ Skill Architecture
  126. This skill provides expertise in three core areas:
  127. ### 1. Remote Access Patterns
  128. - `hass-cli` commands with environment variables
  129. - SSH-based `ha` CLI commands
  130. - Log analysis and error detection
  131. - State verification
  132. ### 2. Deployment Workflows
  133. - **Git workflow**: For final, tested changes
  134. - **scp workflow**: For rapid iteration (dashboards, testing)
  135. - **Reload vs Restart**: Smart decision making
  136. - **Verification protocols**: Always check outcomes
  137. ### 3. Dashboard Development
  138. - **View types**: Panel (full-screen) vs Sections (organized)
  139. - **Card types**: Mushroom, Tile, Template, Auto-entities
  140. - **Template patterns**: Jinja2 snippets for common use cases
  141. - **Debugging**: JSON validation, template testing, entity verification
  142. ## 🤝 Contributing
  143. We welcome contributions from the Home Assistant community! This skill has been developed through real-world usage and we want to keep improving it.
  144. ### What to Contribute
  145. **🎯 Focus on Home Assistant-specific expertise:**
  146. ✅ **GOOD contributions:**
  147. - New template patterns for common use cases
  148. - Solutions to specific HA configuration pitfalls
  149. - Dashboard card examples for different devices
  150. - Integration-specific deployment workflows
  151. - Automation verification patterns
  152. - Log analysis patterns for specific errors
  153. ❌ **AVOID generic contributions:**
  154. - General git workflows (unless HA-specific)
  155. - Generic Python/YAML best practices
  156. - Non-HA development workflows
  157. ### Contribution Guidelines
  158. #### 1. Template Pattern Contributions
  159. Add to the "Common Template Patterns" section:
  160. ```markdown
  161. **Your Pattern Name:**
  162. ```jinja2
  163. {% set entities = [...] %}
  164. {{ your_template_logic }}
  165. ```
  166. **Use case:** Explain when to use this
  167. **Example output:** Show what it produces
  168. ```
  169. #### 2. Dashboard Card Examples
  170. Add to "Real-World Examples":
  171. ```markdown
  172. ### Your Card Name
  173. ```json
  174. {
  175. "type": "...",
  176. ...
  177. }
  178. ```
  179. **Best for:** Device type, use case
  180. **Features:** What makes this example useful
  181. ```
  182. #### 3. Pitfall Solutions
  183. Add to "Common Pitfalls":
  184. ```markdown
  185. **Problem X: Brief description**
  186. - **Symptom:** What the user sees
  187. - **Cause:** Root cause explanation
  188. - **Fix:** Step-by-step solution
  189. ```
  190. #### 4. Workflow Improvements
  191. If proposing workflow changes:
  192. - Explain the problem with current workflow
  193. - Provide specific HA scenario where it applies
  194. - Show before/after comparison
  195. - Include verification steps
  196. ### How to Submit
  197. 1. **Fork the repository**
  198. 2. **Create a feature branch**: `git checkout -b feature/your-contribution-name`
  199. 3. **Make your changes** to `skills/home-assistant-manager/SKILL.md`
  200. 4. **Test thoroughly** in your own HA environment
  201. 5. **Update README.md** if adding new capabilities
  202. 6. **Submit a Pull Request** with:
  203. - Clear description of what you're adding
  204. - Example usage scenario
  205. - Verification that it works in real HA setup
  206. ### Contribution Review Process
  207. PRs are reviewed for:
  208. - ✅ **HA-specific value**: Does it solve a real HA problem?
  209. - ✅ **Accuracy**: Is the information correct and up-to-date?
  210. - ✅ **Clarity**: Is it well-documented and easy to understand?
  211. - ✅ **Tested**: Has it been verified in a real HA environment?
  212. ## 📚 Repository Structure
  213. ```
  214. claude-skill-homeassistant/
  215. ├── .claude-plugin/
  216. │ ├── plugin.json # Plugin manifest
  217. │ └── marketplace.json # Self-hosted marketplace listing this plugin
  218. ├── skills/
  219. │ └── home-assistant-manager/
  220. │ ├── SKILL.md # Main skill content with YAML frontmatter
  221. │ ├── dashboard.png
  222. │ └── reference/
  223. │ ├── automations.md # Modern syntax, modes, blueprints, traces — on demand
  224. │ └── dashboards.md # Lovelace deep-dive, loaded on demand
  225. ├── README.md # This file
  226. └── LICENSE # MIT License
  227. ```
  228. This repo doubles as a Claude Code plugin and a self-hosted marketplace (see [Installation](#-installation)), and the skill itself follows the [official Claude skills specification](https://github.com/anthropics/skills):
  229. - `SKILL.md` contains YAML frontmatter with `name` and `description`
  230. - Content organized in logical sections
  231. - Includes examples, patterns, and workflows
  232. - Focused on actionable expertise
  233. ## 🔧 Environment Setup
  234. For the skill to work optimally, ensure your environment has:
  235. ### SSH Access
  236. ```bash
  237. # Test SSH access
  238. ssh root@homeassistant.local "ha core info"
  239. ```
  240. ### hass-cli Setup
  241. ```bash
  242. # Install hass-cli
  243. pipx install homeassistant-cli
  244. # Set environment variables (add to ~/.bashrc or ~/.zshrc)
  245. export HASS_SERVER=http://homeassistant.local:8123
  246. export HASS_TOKEN=your_long_lived_access_token
  247. # Test hass-cli
  248. hass-cli state list
  249. ```
  250. ### Git Repository
  251. ```bash
  252. # Your HA config should be a git repository
  253. cd /config
  254. git init
  255. git remote add origin your-repo-url
  256. # Claude should be run from this directory
  257. ```
  258. ### Context7 MCP (Optional but Recommended)
  259. ```bash
  260. # Add Context7 for official HA documentation
  261. claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  262. --header "CONTEXT7_API_KEY: your_api_key"
  263. ```
  264. ## 🎨 Use Cases
  265. ### DevOps & Configuration Management
  266. - Rapid automation development and testing
  267. - Safe configuration changes with validation
  268. - Remote HA instance management
  269. - Git-based version control workflow
  270. ### Dashboard Development
  271. - Tablet-optimized control panels
  272. - Wall-mounted dashboard displays
  273. - Mobile-responsive layouts
  274. - Touch-friendly interface design
  275. ### Template Development
  276. - Jinja2 template creation and debugging
  277. - Dynamic sensor calculations
  278. - Conditional automation logic
  279. - Custom card configurations
  280. ### Troubleshooting
  281. - Log analysis and error detection
  282. - Template type error resolution
  283. - Dashboard debugging
  284. - Integration configuration issues
  285. ## 📖 Related Resources
  286. - [Official Claude Skills Repository](https://github.com/anthropics/skills)
  287. - [Home Assistant Documentation](https://www.home-assistant.io/docs/)
  288. - [Lovelace UI Documentation](https://www.home-assistant.io/lovelace/)
  289. - [Home Assistant Community](https://community.home-assistant.io/)
  290. ## 📄 License
  291. MIT License - See [LICENSE](LICENSE) file for details.
  292. ## 👤 Author
  293. **Komal Venkatesh Ganesan**
  294. If you find this skill helpful for managing your Home Assistant setup, consider supporting its development:
  295. <a href="https://www.buymeacoffee.com/komalvenkag" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50"></a>
  296. ## 💬 Support & Discussion
  297. - **Issues**: [GitHub Issues](https://github.com/komal-SkyNET/claude-skill-homeassistant/issues)
  298. - **Discussions**: [GitHub Discussions](https://github.com/komal-SkyNET/claude-skill-homeassistant/discussions)
  299. - **Home Assistant Community**: Tag contributions with `claude-skill`
  300. ---
  301. **Made with ❤️ for the Home Assistant community**

Ratings and comments

Sign in to rate this skill.

Sign in

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