New to Claude Skills? Learn how to install them →

home-assistant on GitHub

Home Assistant Code Review

Free

Streamline your code review process with structured feedback.

Get this skill

Free · Opens the source repo

What Home Assistant Code Review does

The Home Assistant Code Review skill is designed to assist developers in evaluating code changes within the Home Assistant ecosystem. It provides a systematic approach to reviewing code by analyzing various aspects such as code quality, potential bugs, performance issues, and security concerns. By using this skill, reviewers can ensure that their feedback is consistent and constructive, ultimately leading to higher quality code submissions.

When a review is requested, this skill guides the user to review the full set of changes against the target branch, ensuring that all relevant modifications are considered. It emphasizes the importance of providing specific comments for each file and line that requires attention, which helps maintain clarity and focus during the review process. The skill also includes a quality scale verification step, allowing users to check for adherence to any defined quality standards.

One of the key features of this skill is its ability to run parallel subagents for each finding, which enhances the review process by providing a thorough double-check of potential issues. This capability allows reviewers to gather comprehensive results and summarize them effectively in their final comments. The structured output format ensures that reviewers can clearly communicate their overall assessment, whether it be approval, requests for changes, or general comments.

This skill is particularly useful for teams working on collaborative projects where code quality and consistency are paramount. It can be applied not only to Home Assistant code changes but also to general code reviews in various development environments, making it a versatile tool for developers seeking to improve their code review practices.

When to use it

Use this skill when conducting code reviews to maintain quality and consistency in feedback.

When not to use it

This skill is not suitable for making code changes; it is strictly for review purposes only.

What you can build with it

Reviewing Pull Requests

Use this skill to review pull requests in Home Assistant, ensuring all changes are evaluated against the target branch.

Quality Assurance Checks

Employ the skill during quality assurance phases to identify potential bugs, performance issues, and security concerns in the code.

Consistent Feedback for Teams

Implement this skill in team workflows to maintain a consistent review process and improve overall code quality.

How to install Home Assistant Code Review

View source

1. Install with the skills CLI

npx skills add home-assistant/core/ha-review --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by home-assistant

Review Code Changes

Scope:

  • Unless instructed otherwise, review the full changes (the ones from the branch plus uncommitted ones) against the target branch. Resolve the base to an available ref (prefer upstream/<base>, then origin/<base>, then local <base>) and review git diff "$(git merge-base "$BASE_REF" HEAD)"; use dev as the default base.

Analyze the code changes for:

  • Code quality and style consistency
  • Potential bugs or issues
  • Performance implications
  • Security concerns
  • Test coverage
  • Documentation updates if needed

Quality scale:

  • If the changes include a quality_scale.yaml file, run a subagent to verify all the added or modified rules, following the ha-quality-scale-verify skill.
  • Include the verification results in the final review comments.

Verification:

  • After the review, run parallel subagents for each finding to double-check it.
  • Spawn up to a maximum of 10 parallel subagents at a time.
  • Gather the results from the subagents and summarize them in the final review comments.

IMPORTANT:

  • Just review. DO NOT make any changes.
  • Be constructive and specific in your comments.
  • Suggest improvements where appropriate.
  • No need to run tests or linters, just review the code changes.
  • No need to highlight things that are already good.

Output format:

  • List specific comments for each file/line that needs attention.
  • In the end, summarize with an overall assessment (approve, request changes, or comment) and bullet point list of changes suggested, if any.
    • Example output:
      Overall assessment: request changes.
      - [CRITICAL] sensor.py:143 - Memory leak
      - [PROBLEM] data_processing.py:87 - Inefficient algorithm
      - [SUGGESTION] test_init.py:45 - Improve x variable name
      
    • Make sure to include the file and line number when possible in the bullet points.

Frequently asked questions about Home Assistant Code Review

Similar skills