Reviewer Skill

Perform Phase 5 code reviews assessing quality and project rule compliance.

4|1|Updated Oct 8, 2025
One-click install
npx skills add https://github.com/deMGoncalves/arq-specs-template --skill reviewer-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Reviewer Skill
Source: https://github.com/deMGoncalves/arq-specs-template/tree/main/.claude/skills/reviewer
Command: npx skills add https://github.com/deMGoncalves/arq-specs-template --skill reviewer-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill standardizes and automates code review processes, ensuring consistent application of project-specific rules and universal software quality criteria. It reduces human effort in identifying common issues, leading to higher code quality and fewer bugs.

Core Features & Use Cases

  • 12-Criterion Software Quality Assessment: Evaluates code across three dimensions (Operation, Review, Transition) using 12 objective criteria like correctness, maintainability, flexibility, and testability.
  • Project Rule Compliance: Checks adherence to .claude/rules/ (e.g., SRP, DRY, KISS, test coverage), providing specific rule numbers for violations.
  • Detailed Issue Reporting: Classifies identified issues by category, criterion, location, description, and severity (Critical, High, Medium, Low), offering actionable suggestions for correction.
  • Use Case: After a developer completes implementation and tests, this Skill performs a comprehensive code review. It identifies issues like poor naming, high coupling, or missing test coverage, providing a structured report that guides the developer to improve the code before human review.

Quick Start

After code implementation and testing are complete, invoke the Reviewer: @skill code-review

Frequently Asked Questions about Reviewer Skill

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

FAQPage Schema
How do I automate code reviews to check software quality?

Code review automation assesses software quality by applying project-specific rules and universal criteria across Operation, Revision, and Transition dimensions. The Reviewer Skill checks adherence to .claude rules, identifies violations with severity levels, and produces detailed reports with recommended fixes to improve code maintainability and compliance.

What does a code review check for in terms of software quality?

Software quality reviews evaluate 12 objective criteria across three dimensions: Operation (correctness, performance), Revision (maintainability, flexibility, testability), and Transition (portability, compatibility). The Skill identifies issues like poor naming, high coupling, missing test coverage, and violations of principles like DRY and KISS with specific rule numbers and severity classifications.

Can I use code reviews to enforce project-specific coding standards?

Yes. The Reviewer Skill checks compliance against project rules stored in .claude/rules/ directories, such as Single Responsibility Principle, Don't Repeat Yourself, and test coverage requirements. It validates adherence to architecture and specifications, producing structured reports that classify violations by category, location, and severity.

How do I reduce code review effort while maintaining quality standards?

Automated code reviews standardize and streamline the review process by identifying common issues before human review. The Skill performs comprehensive assessments across quality criteria, rule compliance, and architectural alignment, reducing manual effort and enabling developers to address issues systematically with actionable correction suggestions.

What's the best way to integrate code reviews into a development workflow?

Invoke code reviews after implementation and testing are complete. The Reviewer Skill produces a comprehensive report detailing violations, their severity, and recommended fixes. Developers use this structured feedback to improve code compliance and maintainability before human review, creating a feedback loop that accelerates iteration.

Do code reviews identify testability and maintainability issues?

Yes. Testability and maintainability are explicit criteria within the Revision dimension of the quality assessment. The Skill detects issues affecting these areas—such as high coupling, unclear naming, and missing test coverage—classifies them by severity, and provides specific guidance to improve code portability and flexibility.