ha-apps

Generate Home Assistant add-on scaffolds from Docker images or GitHub repositories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, git, docker, grep, awk, sed, find, mktemp, tar, and includes scripts (resource) components.

What problem does it solve?

This skill automates the creation of Home Assistant add-ons from Docker images or GitHub repositories, reducing manual setup and potential misconfigurations.

Core Features & Use Cases

  • Discovery and analysis of Docker images or GitHub repos to infer ports, volumes, environments, and base OS.
  • Scaffold generation for add-ons, including config.yaml, Dockerfile, DOCS.md, and rootfs templates (ingress-enabled where applicable).
  • Ingress template support and documentation to streamline embedding a web UI in Home Assistant.
  • Ideal for wrapping existing containerized apps for Home Assistant, analyzing images for add-on feasibility, and exporting ready-to-publish add-ons.

Quick Start

  1. Run the discovery workflow on a Docker image or repository to generate an initial scaffold.
  2. Review and customize the generated config.yaml, Dockerfile, and docs.
  3. Build and load the add-on into Home Assistant, enable ingress, and perform end-to-end testing.

Frequently Asked Questions about ha-apps

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 Docker image?

Creating a Home Assistant add-on from a Docker image involves running a discovery script that analyzes the image to infer ports, volumes, and environments, then automatically generates a complete add-on scaffold with config.yaml and Dockerfile.

What is Home Assistant ingress and how do I add it to my add-on?

Home Assistant ingress embeds a web UI directly into the Home Assistant frontend. The scaffold generation process creates ingress-enabled templates and documentation to streamline embedding your web UI without manual routing configuration.

Do I need Docker and git installed to generate Home Assistant add-on scaffolds?

Generating Home Assistant add-on scaffolds requires Docker and git, along with dependencies like curl, jq, grep, awk, sed, find, mktemp, and tar to analyze repositories and build runnable deployment templates.

Can I build Home Assistant add-ons directly from GitHub repositories?

Yes, you can build Home Assistant add-ons directly from GitHub repositories. The discovery workflow analyzes the repository to infer the base OS and configurations, generating a ready-to-publish add-on with supporting documentation.

What is the best way to wrap an existing containerized app for Home Assistant?

The best way to wrap a containerized app for Home Assistant is using an automated scaffold generator that creates the necessary config.yaml, Dockerfile, and rootfs templates from the image, supporting both s6-overlay v2 and v3 templates.

Why does my generated Home Assistant add-on need an s6-overlay template?

Your generated Home Assistant add-on needs an s6-overlay template to manage service initialization and process supervision within the container. The scaffold generation supports both s6-overlay v2 and v3 templates for automated deployment workflows.