spec-first:spec-review

Review spec.md files for quality, generating a checklist and C10 score.

72|9|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/sunrain520/spec-first --skill spec-first-spec-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-first:spec-review
Source: https://github.com/sunrain520/spec-first/tree/main/skills/spec-first/20-spec-review
Command: npx skills add https://github.com/sunrain520/spec-first --skill spec-first-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the quality review of requirement specifications, ensuring they are complete, clear, testable, and consistent, thereby improving the overall quality of AI-generated code and documentation.

Core Features & Use Cases

  • Automated Quality Checks: Performs a systematic review of spec.md files against predefined criteria.
  • Scoring (C10): Generates a "Spec Quality Score" (C10) to quantify the specification's quality.
  • Use Case: Before proceeding to the design phase, a product manager uses this Skill to automatically check a new feature's specification document for completeness and clarity, identifying any ambiguities or missing information.

Quick Start

Run the spec-first:spec-review skill to review the current feature's specification.

Frequently Asked Questions about spec-first:spec-review

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

FAQPage Schema
How do I review a requirement specification for completeness and testability?

To review a requirement specification for completeness and testability, you can use an automated spec review tool that analyzes your `spec.md` file. It generates a checklist and a C10 quality score, identifying issues and providing actionable revision suggestions to improve specification clarity.

What is a C10 score in specification quality assurance?

A C10 score in specification quality assurance is a quantitative metric generated by reviewing a `spec.md` file. It quantifies the overall quality of the requirement specification based on completeness, clarity, testability, and consistency, helping product managers validate features before design.

How do I automatically locate and validate feature specifications?

You can automatically locate and validate feature specifications by running an automated spec review skill. It supports automated feature location via `.spec-first/current` or interactive selection, analyzes the `spec.md` file, and outputs the validation results to `checklists/spec-review.md`.

Does specification review work without manual file selection?

Yes, specification review works without manual file selection by using automated feature location via `.spec-first/current`. If this file is absent, it falls back to interactive selection, allowing you to manually choose the target `spec.md` file for quality analysis.

Why does my requirement analysis lack consistency and clarity?

Your requirement analysis may lack consistency and clarity due to missing information or ambiguities in the `spec.md` file. An automated specification review identifies these specific issues against predefined criteria and provides actionable revision suggestions to resolve them.

When do I need to perform a specification review in the AI development workflow?

You need to perform a specification review in the AI development workflow before proceeding to the design phase. Reviewing the `spec.md` file ensures the requirements are complete, clear, testable, and consistent, which improves the overall quality of AI-generated code and documentation.