skills.rest
teliha
telihaOFFICIAL
Explore all skills by this author →
GitHub

spec-review

Review specifications for completeness, clarity, testability, and quality.

Updated Dec 9, 2025
Search Tags:#documentation#specification#requirements#quality#review
One-click install
npx skills add https://github.com/teliha/dev-workflows --skill spec-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/teliha/dev-workflows/tree/main/skills/spec-review
Command: npx skills add https://github.com/teliha/dev-workflows --skill spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates specification ambiguity by systematically reviewing documents for testability, edge cases, and technical feasibility.

Core Features & Use Cases

  • Quality Assurance: Ensure specifications are complete, clear, and implementable.

Quick Start

spec review --mode quick specs/feature/spec.md spec review -m standard specs/feature/spec.md spec review specs/feature/spec.md

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I review specifications for completeness before implementation?▼

Specification review systematically evaluates documents for completeness, clarity, testability, and technical feasibility to catch ambiguities early. Use spec-review with your spec file to identify gaps, edge cases, and implementability issues before development starts, reducing costly rework.

What should I check when reviewing requirements and design documentation?▼

Thorough specification review covers functional requirements, technical constraints, acceptance criteria, edge cases, and testability. The review applies multiple evaluation categories in parallel to ensure your spec is clear enough for implementation and QA without requiring clarification loops.

Can I run quick specification reviews on my design docs?▼

Yes. Spec-review supports mode-controlled depth: use --mode quick for fast feedback on key gaps, --mode standard for comprehensive review, or --mode thorough for detailed analysis. Choose the mode based on your timeline and how early in design you're reviewing.

Does specification review work with specifications in my project structure?▼

Specification review automatically activates on spec changes within specs/ directories and related design docs. It handles new specifications, edits, and acceptance criteria during both manual and automated review workflows with standardized markdown and JSON outputs for traceability.

What are the limitations of automated specification review?▼

Automated review identifies structural gaps, clarity issues, and testability concerns, but domain-specific validation and stakeholder sign-off still require human judgment. The tool flags ambiguities and missing edge cases; final approval decisions rest with your team.

How does specification review integrate into my documentation workflow?▼

Spec-review produces standardized markdown and JSON outputs designed for traceability and integration into CI/CD pipelines. Results support iterative improvement loops, allowing you to refine specs based on feedback and track quality metrics across documentation changes.

Related Skills

javierteliozjaviertelioz

create-specification

Generate Markdown specification documents with YAML frontmatter in the spec/ directory.

Community
Intermediate
AZANIRAZANIR
2

qa-testcase-from-docs

Generate structured test cases from requirements documents using ISO 29119-4 models.

Community
Advanced
pradyumnasagarpradyumnasagar
6

agent-handoff

Automate inter-skill data transfer and provenance capture via JSON Material Passports.

Community
Advanced
alexandersumeralexandersumer
1

external-peer-review

Triggers an external peer-agent code review with bounded timeouts and turn limits.

Community
Advanced