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.