claude-skill-homeassistant  by komal-SkyNET

AI expert skill for Home Assistant automation and dashboard development

Created 2 months ago
291 stars

Top 90.9% on SourcePulse

GitHubView on GitHub
Project Summary

This Claude Code skill transforms Claude into an expert for managing Home Assistant configurations, automating workflows, and developing Lovelace dashboards. It targets Home Assistant users seeking to leverage AI for efficient deployment, robust testing, and streamlined dashboard creation, offering advanced capabilities beyond standard AI assistants.

How It Works

The skill equips Claude with specialized knowledge and workflows for Home Assistant. It employs a hybrid deployment strategy using git for version control and scp for rapid iteration, enabling instant testing of changes. The system intelligently determines whether to perform a "smart reload" or a full "restart" based on the nature of the configuration update, ensuring minimal downtime. It also incorporates a complete verification protocol for automations, including manual triggering and log analysis, and provides expertise in developing tablet-optimized Lovelace dashboards with touch-friendly controls and responsive layouts.

Quick Start & Requirements

  • Primary install / run command: Clone the repository into .claude/skills/home-assistant-manager within your Home Assistant config directory, or download and extract.
  • Non-default prerequisites and dependencies:
    • Claude Code installed and configured.
    • Home Assistant instance with SSH access enabled.
    • Git repository connected to the /config directory.
    • hass-cli installed (pipx install homeassistant-cli).
    • SSH key authentication configured.
    • Environment variables set: HASS_SERVER, HASS_TOKEN.
    • Optional: Context7 MCP for official HA documentation.
  • Links:
    • Full Workflow Demo: https://github.com/user-attachments/assets/eab53b18-ae2b-4d43-b1e4-e45bf9357099
    • Quick Skill Check: https://github.com/user-attachments/assets/a215df83-ce84-4ed2-bb93-f3a3ee0c43e8

Highlighted Details

  • Expert-level Home Assistant configuration management with rapid development workflows.
  • Smart Reload vs Restart decision-making for efficient deployments.
  • Configuration validation before applying changes to prevent downtime.
  • Remote CLI access via SSH and hass-cli.
  • Complete automation verification protocol including log analysis.
  • Tablet-optimized Lovelace dashboard development with specific screen size considerations.
  • Jinja2 template patterns for common use cases and solutions to common pitfalls.

Maintenance & Community

The skill is authored by Komal Venkatesh Ganesan and welcomes contributions from the Home Assistant community. Contributions are focused on Home Assistant-specific expertise, such as new template patterns, dashboard card examples, and workflow improvements. Links to GitHub Issues and Discussions are provided for support and collaboration.

Licensing & Compatibility

The project is released under the MIT License, which generally permits commercial use and integration into closed-source projects with minimal restrictions.

Limitations & Caveats

The skill's functionality is dependent on a correctly configured Home Assistant environment with enabled SSH access, a connected Git repository, and properly set environment variables for hass-cli. Its effectiveness relies on the user's ability to meet these prerequisites.

Health Check
Last Commit

2 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
1
Star History
69 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.