speckit-review

Automate pull request reviews across code quality, tests, and error handling.

1|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/payangar-dev/texlab --skill speckit-review-payangar-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-review
Source: https://github.com/payangar-dev/texlab/tree/main/.agents/skills/speckit-review
Command: npx skills add https://github.com/payangar-dev/texlab --skill speckit-review-payangar-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you catch quality issues early in a pull request by running a structured, multi-aspect review that analyzes code, comments, tests, error handling, and types, then proposes simplifications.

Core Features & Use Cases

  • Comprehensive multi-aspect PR reviews: runs focused checks for code quality, comment accuracy, test coverage, error handling, and type design.
  • Change-aware and config-driven scope: detects changed files and selectively runs agents based on config toggles and requested aspects.
  • Actionable aggregation and fix-first guidance: consolidates findings into critical/important/suggestion categories and provides a recommended action plan.
  • Use case: Review a PR that modifies core modules and introduces new logic by ensuring tests, errors, and type invariants are scrutinized before merging.

Quick Start

Run the review on the current pull request by telling the assistant: /speckit.review

Frequently Asked Questions about speckit-review

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

FAQPage Schema
How do I automate pull request reviews for code quality and test coverage?

You can review a PR by running /speckit.review, which detects changed files and runs specialized agents sequentially or in parallel based on your configuration. It analyzes code quality, comments, tests, error handling, and types to produce an aggregated issue summary.

How does change-aware code review work for modified core modules?

Change-aware code review works by detecting changed files via a dedicated bash script and selectively running analysis agents based on configured toggles. It scrutinizes modified modules and new logic to catch quality issues early before merging.

Can I customize which analysis agents run during a pull request review?

Yes, you can customize which agents run by setting toggles in the review configuration file at .specify/extensions/review/review-config.yml with fallback to extension.yml. The system respects these toggles unless explicitly overridden by user-requested aspects.

What is the best way to consolidate error handling and type design feedback from a PR?

The best way is to use a multi-aspect review that consolidates findings from specialized agents into critical, important, and suggestion categories. This produces an aggregated issue summary with a fix-first action plan for error handling and type design.

Do I need a specific project structure to run spec-kit code reviews?

Yes, spec-kit code reviews require a specific project structure to read optional review configuration and execute changed-file detection. The system looks for config in .specify/extensions/review/review-config.yml with fallback to extension.yml, and uses scripts in .specify/scripts/bash/.

How do I prioritize code simplification suggestions from a multi-aspect review?

Code simplification suggestions are prioritized through an aggregated summary that categorizes findings into critical, important, and suggestion tiers, providing a recommended action plan to address the most impactful issues first.