spec-review

Review software specifications for completeness, clarity, and testability.

1|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/Varuas37/spec-test --skill spec-review-varuas37
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/Varuas37/spec-test/tree/main/src/spec_test/skills/spec-review
Command: npx skills add https://github.com/Varuas37/spec-test --skill spec-review-varuas37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides reviewers to assess specifications for completeness, clarity, and testability, reducing misalignment between requirements and implementation.

Core Features & Use Cases

  • Structured review workflow: evaluate uniqueness, atomicity, completeness, and traceability of specs against user stories and business goals.
  • Practical guidance for PR reviews, design sign-offs, and sprint planning, including templates and example checks.
  • Collaboration support: documents findings with a reviewer-friendly template and exportable reports.

Quick Start

Run spec-test list-specs to view all specs, then run spec-test verify to generate a review report. Open the generated report to identify gaps, and use the review template to document findings.

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I review software specifications for completeness and testability?

Software specification review validates completeness, clarity, and testability by applying a structured checklist evaluating uniqueness, atomicity, traceability, and appropriate verification types against user stories and business goals. This reduces misalignment between requirements and implementation.

How do I verify spec quality during a pull request review?

Verifying spec quality during a pull request review involves checking specification atomicity and traceability against business goals. You generate a review report to identify gaps and use a reviewer-friendly template to document findings for the team.

What is a specification review checklist for sprint planning?

A specification review checklist for sprint planning is a structured framework assessing uniqueness, atomicity, completeness, and traceability of specs. It ensures requirements are clearly defined and testable before development begins, reducing implementation misalignment.

Can I automate generating a design sign-off report from spec files?

You can generate a design sign-off report by running verification commands against spec files to output an exportable report. This report identifies gaps in the specifications and documents findings using a reviewer-friendly template for collaboration.

What are the limitations of manual spec verification during sprint planning?

Manual spec verification during sprint planning often lacks a structured checklist for uniqueness and traceability, leading to misalignment between requirements and implementation. Automated verification generates consistent reports to identify gaps more reliably than manual checks.