ha-hacs

Validate Home Assistant Community Store metadata requirements for custom integrations.

6|1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill ha-hacs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-hacs
Source: https://github.com/L3DigitalNet/Claude-Code-Plugins/tree/main/plugins/home-assistant-dev/skills/ha-hacs
Command: npx skills add https://github.com/L3DigitalNet/Claude-Code-Plugins --skill ha-hacs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers ensure their Home Assistant integrations meet the metadata requirements for distribution via HACS (Home Assistant Community Store).

Core Features & Use Cases

  • Metadata Validation: Checks for required fields in manifest.json and hacs.json.
  • Repository Structure Guidance: Provides a clear overview of the expected file and folder layout.
  • Use Case: Before submitting your new Home Assistant integration to the HACS default repository, use this skill to verify that your manifest.json and hacs.json files contain all the necessary fields and that your repository structure is correct.

Quick Start

Validate the HACS metadata for my Home Assistant integration.

Frequently Asked Questions about ha-hacs

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

FAQPage Schema
What metadata is required to publish a custom integration to HACS?

Publishing a custom integration to HACS requires correctly structured `manifest.json` and `hacs.json` files, alongside a compliant repository structure. This Skill validates those exact metadata fields to ensure your repository meets the Home Assistant Community Store distribution policies.

How do I validate my Home Assistant integration's manifest.json for HACS?

You validate your `manifest.json` for HACS by checking it against the required fields outlined by the Home Assistant Community Store. This Skill guides you through verifying that all necessary configuration keys are present for successful integration distribution.

Does HACS require a specific repository structure for custom integrations?

HACS does require a specific repository structure for custom integrations to function correctly within the store. This Skill provides clear guidance on the expected file and folder layout to ensure your integration passes validation checks.

What is the purpose of hacs.json in a Home Assistant integration?

The `hacs.json` file defines specific metadata required by the Home Assistant Community Store to properly list and manage your custom integration. This Skill helps verify that your `hacs.json` contains all necessary fields for store compliance.

Why is my Home Assistant integration failing HACS validation?

Your integration is likely failing HACS validation due to missing required fields in `manifest.json` or `hacs.json`, or an incorrect repository structure. Use this Skill to identify and fix these metadata compliance issues before submission.

Can I use ha-hacs to check my repository structure before submitting to the HACS default repository?

You can use this Skill to check your repository structure before submitting to the HACS default repository. It verifies the expected file and folder layout alongside required `manifest.json` and `hacs.json` fields to ensure full compliance.