skills.rest
home-assistant
home-assistantOFFICIAL
Explore all skills by this author →
Website𝕏@home_assistantGitHub

ha-review

Review Home Assistant code changes and provide structured feedback.

90.2k|38.4k|Updated Sep 17, 2013
Search Tags:#static analysis#home assistant#quality scale#Git diff#Code review#Pull request
One-click install
npx skills add https://github.com/home-assistant/core --skill ha-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ha-review
Source: https://github.com/home-assistant/core/tree/main/.claude/skills/ha-review
Command: npx skills add https://github.com/home-assistant/core --skill ha-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manual code reviews are inconsistent, time-consuming, and often miss critical issues like security flaws, performance regressions, or missing test coverage. This Skill enforces a consistent review workflow for Home Assistant pull requests and local branches.

Core Features & Use Cases

  • Diff Analysis: Reviews the full set of changes against the target branch by resolving the merge base from upstream, origin, or local refs.
  • Quality Scale Verification: Detects quality_scale.yaml files and delegates rule verification to a subagent following the ha-quality-scale-verify skill.
  • Parallel Verification: Spawns up to 10 parallel subagents to double-check each finding before producing the final summary.
  • Use Case: A contributor opens a pull request adding a new sensor platform. Use this Skill to review the diff for code quality, test coverage, and documentation updates, then output a structured list of CRITICAL, PROBLEM, and SUGGESTION comments with file and line references.

Quick Start

Review the current branch changes against the dev branch and provide a structured code review with severity-tagged comments.

Frequently Asked Questions about ha-review

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

FAQPage Schema
How do I review a Home Assistant pull request for code quality?▼

Use the ha-review skill to analyze the diff against the target branch. It checks code quality, potential bugs, performance, security, test coverage, and documentation, then outputs severity-tagged comments with file and line references.

What does the Home Assistant quality_scale.yaml file do?▼

The quality_scale.yaml file declares rules a new integration must satisfy. The ha-review skill detects this file and runs a subagent to verify each added or modified rule against the actual code changes.

How do I find the merge base for a Home Assistant branch review?▼

Resolve the base ref by checking upstream/<base>, then origin/<base>, then local <base>. Use git diff against the merge-base commit with HEAD, defaulting to the dev branch when no base is specified.

Can the ha-review skill make code changes automatically?▼

No. The skill is strictly read-only and only produces review comments. It explicitly does not run tests, linters, or modify any files in the repository.

Why does the review spawn parallel subagents for verification?▼

Parallel subagents double-check each finding to reduce false positives. The skill spawns up to 10 subagents concurrently and aggregates their results into the final review summary.

Related Skills

Explore More Software Engineering Skills→
usesofiausesofia

git-merge

Fetch origin/main, merge it into the current branch, resolve conflicts, run tests, and push.

Official
Intermediate
hideki5123hideki5123
2

self-pr-review

Automate pull request review loops with Copilot and Gemini feedback.

Community
Advanced
chriswchchriswch
2

code-reviewing

Review completed code across five layers and generate a structured report.

Community
Advanced
kartikfedkartikfed

python-quality

Run Black, Ruff, Mypy, and Pytest checks on Python code.

Community
Intermediate