spec-review

Validate and critique feature specification completeness using Python scripts.

3|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/artsmc/claude-dev-agents --skill spec-review-artsmc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/artsmc/claude-dev-agents/tree/main/skills/spec-review
Command: npx skills add https://github.com/artsmc/claude-dev-agents --skill spec-review-artsmc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the validation and critique of generated specifications to ensure completeness and quality across the development lifecycle.

Core Features & Use Cases

  • Phase-based validation: checks structure and required components (FRD, FRS, GS, TR, and task-list) for completeness.
  • Automated critique: evaluates requirement clarity, task granularity, technical design, and testability to surface quality issues.
  • Iterative feedback loop: presents findings to users and collects input to drive timely revisions.
  • Guided workflow: orchestrates validation, critique, and user decision making to accelerate specification preparation.

Quick Start

Run the validation workflow on a feature specification directory, for example: python skills/spec/scripts/validate_spec.py /path/to/feature-{name}

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I automate spec validation and critique for feature specifications?

You can automate spec validation and critique by running the validate_spec.py and critique_plan.py scripts on a feature specification directory to perform structure checks, evaluate requirement clarity, and generate actionable reports.

What is phase-based validation for development workflow specifications?

Phase-based validation checks the structure and required components of a feature specification, including FRD, FRS, GS, TR, and task-list, to ensure completeness across the development lifecycle.

How do I check if my technical requirements and task granularity are testable?

Automated critique evaluates requirement clarity, task granularity, technical design, and testability to surface quality issues within your feature specifications, producing prompts for user decisions.

Can I iterate on specification revisions automatically during project preparation?

Yes, an iterative feedback loop presents validation findings and critique reports to users, collecting input to drive timely guided revisions and accelerate specification preparation.

What components do I need to run automated specification validation scripts?

You need the validate_spec.py and critique_plan.py scripts included in the skill's scripts component, along with a feature specification directory containing the required documentation components.

When should I avoid automated specification validation in my development workflow?

Automated specification validation targets feature specifications within project workspaces; it may not suit projects lacking structured FRD, FRS, GS, TR, and task-list components required for completeness checks.