ha-quality-scale-verify

Verify Home Assistant integration compliance with quality scale rules.

90.2k|38.4k|Updated Sep 17, 2013
One-click install
npx skills add https://github.com/home-assistant/core --skill ha-quality-scale-verify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ha-quality-scale-verify
Source: https://github.com/home-assistant/core/tree/main/.claude/skills/ha-quality-scale-verify
Command: npx skills add https://github.com/home-assistant/core --skill ha-quality-scale-verify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually auditing a Home Assistant integration against dozens of quality scale rules across Bronze, Silver, Gold, and Platinum tiers is time-consuming and error-prone. This Skill automates the verification process by fetching official rule documentation and cross-referencing it with the integration's codebase.

Core Features & Use Cases

  • Rule Documentation Fetching: Retrieves official rule definitions from the Home Assistant developers documentation repository.
  • Codebase Analysis: Examines manifest.json, quality_scale.yaml, and relevant Python modules to verify implementation patterns.
  • Tier-Aware Verification: Applies cumulative rule requirements based on the integration's declared quality tier.
  • Use Case: A developer wants to know if their custom integration qualifies for Silver tier. Use this Skill to check each Silver rule in parallel and receive a focused report listing only the rules with compliance issues.

Quick Start

Verify whether the peblar integration follows the config-flow quality scale rule.

Frequently Asked Questions about ha-quality-scale-verify

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

FAQPage Schema
How do I check if a Home Assistant integration follows a quality scale rule?

Fetch the rule documentation from the developers.home-assistant repository and compare it against the integration's manifest.json, quality_scale.yaml, and Python source files. The verification checks for done, todo, or exempt status and validates actual implementation against rule requirements.

What is the Home Assistant integration quality scale?

The quality scale is a tiered system (Bronze, Silver, Gold, Platinum) that defines mandatory patterns and configurations for integrations. Each tier contains specific rules like config-flow, entity-unique-id, and parallel-updates that integrations must implement to qualify.

Can I verify multiple quality scale rules at once?

Yes, run parallel subagents to verify each rule in a tier simultaneously. The Skill processes one rule at a time per agent, then aggregates findings into a single report listing only rules with compliance issues.

Why is my integration failing the config-flow quality scale rule?

Common failures include missing config_flow.py module, incorrect ConfigFlow class inheritance, or absence of proper user input validation. The rule requires a complete configuration flow implementation following Home Assistant conventions.

What happens when a quality scale rule is marked exempt?

The verification checks whether the exemption reason documented in quality_scale.yaml is valid for that specific rule. Invalid or unjustified exemptions are flagged as issues requiring resolution.