ha-addons

Scaffold and validate Home Assistant add-ons with config.yaml and Dockerfile artifacts.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/rigerc/ha-apps --skill ha-addons
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-addons
Source: https://github.com/rigerc/ha-apps/tree/main/.claude/skills/ha-addons
Command: npx skills add https://github.com/rigerc/ha-apps --skill ha-addons

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, git, docker, tar, and includes scripts (resource) and references (resource) components.

What problem does it solve?

The ha-addons skill helps users design, scaffold, and validate Home Assistant add-ons, simplifying the process of wrapping apps, creating add-ons from templates, and documenting configuration for the Supervisor ecosystem.

Core Features & Use Cases

  • Discovery-driven scaffolding: Quickly analyze a repository or Docker image to generate add-on skeletons and reduce manual setup.
  • Config guidance & templating: Produce a structured config.yaml, translations, and documentation stubs based on discovered data.
  • Workflow orchestration: Guide Phase-based workflows from discovery through deployment, including optional file collection (Dockerfile, docker-compose, etc.).
  • Use Case: Convert a GitHub project into a Home Assistant add-on with minimal manual steps.

Quick Start

Use the ha-addons skill to scaffold an add-on from a public repository or image by initiating the discovery step and following its prompts.

Frequently Asked Questions about ha-addons

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Home Assistant add-on from an existing GitHub repository?

Home Assistant add-on creation from a GitHub repository is automated through discovery-driven scaffolding, analyzing the project to generate an add-on skeleton with minimal manual steps. It guides the workflow from initial discovery through deployment configuration.

What is needed in a Home Assistant add-on config.yaml file?

A Home Assistant add-on config.yaml requires structured metadata including architecture, ports, volumes, and translations. This skill provides config guidance and templating to generate these validated fields and documentation stubs based on discovered repository data.

Can I use Docker and docker-compose files when building a Home Assistant add-on?

Docker and docker-compose files can be used when building Home Assistant add-ons. This skill orchestrates optional file collection, validating and organizing artifacts like Dockerfiles and docker-compose configurations to ensure compatibility within the Supervisor ecosystem.

Do I need Docker and git installed to scaffold Home Assistant add-ons?

Docker and git are required dependencies, along with curl, jq, and tar, to scaffold Home Assistant add-ons. These tools are necessary for the skill to execute repository discovery, analyze Docker images, and perform file extraction operations.

What is the best way to wrap an existing application into a Home Assistant add-on?

The best way to wrap an existing application into a Home Assistant add-on is through discovery-driven scaffolding, which analyzes the Docker image or repository to generate a validated add-on skeleton. This approach produces proper config.yaml metadata and documentation stubs for the Supervisor ecosystem.