spec-reviewer

Validate specification documents against an 11-point checklist and generate markdown review reports.

2|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/onejaejae/skills --skill spec-reviewer-onejaejae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-reviewer
Source: https://github.com/onejaejae/skills/tree/main/plugins/ai-registry/common/spec-pipeline/skills/spec-reviewer
Command: npx skills add https://github.com/onejaejae/skills --skill spec-reviewer-onejaejae

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that specifications or planning documents are complete and free of critical omissions from a development perspective, preventing costly rework later in the development cycle.

Core Features & Use Cases

  • Automated Spec Validation: Checks for missing edge cases, state transitions, and data constraints against a defined checklist.
  • Development Readiness Assessment: Provides a clear PASS/FAIL judgment based on the severity of identified gaps.
  • Use Case: Before starting development on a new feature, use this Skill to review the product spec. It will identify any ambiguities or missing details that could block or delay the engineering team, allowing the product manager to refine the spec before coding begins.

Quick Start

Use the spec reviewer skill to validate the specification document located at specs/user-profile-spec.md.

Frequently Asked Questions about spec-reviewer

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

FAQPage Schema
How do I validate a product spec for development readiness before coding begins?

To validate a product spec for development readiness, use an automated checklist to assess completeness, identify missing edge cases, and flag ambiguities. This generates a structured review report with a clear PASS or FAIL judgment to prevent engineering rework.

What is gap analysis in specification documents and how does it prevent development rework?

Gap analysis in specification documents identifies missing state transitions, data constraints, and non-functional requirements before engineering starts. Detecting these development readiness gaps early prevents costly rework and delays by allowing product managers to refine the spec.

How do I check my feature specification for missing edge cases and data constraints?

Checking a feature specification for missing edge cases and data constraints requires running the document through an 11-point checklist validation. This coverage analysis scans for omitted state transitions and non-functional requirements, outputting a markdown review report.

Can I use an automated spec review tool with unstructured planning documents?

Yes, you can review unstructured planning documents for development readiness. The validation process supports both structured and unstructured input formats, applying the same 11-point checklist to identify gaps and generate a PASS/FAIL assessment.

What is the best way to assess if a product spec is ready to hand off to the engineering team?

The best way to assess if a product spec is ready for engineering is to perform an automated development readiness validation. This evaluates the document against an 11-point checklist, surfacing missing edge cases and providing a definitive PASS/FAIL judgment.

When do I need a specification review to identify missing non-functional requirements?

You need a specification review to identify missing non-functional requirements when a feature spec lacks clear data constraints or state transitions. Running this validation before development starts ensures the engineering team has the complete details required to proceed.