One-click install
npx skills add https://github.com/Codagent-AI/agent-skills --skill review-spec-codagent-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-spec
Source: https://github.com/Codagent-AI/agent-skills/tree/main/skills/review-spec
Command: npx skills add https://github.com/Codagent-AI/agent-skills --skill review-spec-codagent-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Design artifacts like proposals, specs, and task lists often contain internal contradictions, cross-document misalignments, gaps, or untestable requirements that lead to wasted implementation effort, rework, and misaligned deliverables when teams build without pre-implementation review.

Core Features & Use Cases

  • Cross-Artifact Consistency Checks: Identifies contradictions, scope drift, dropped items, and terminology mismatches between linked design documents.
  • Requirement & Task Validation: Ensures requirements have testable scenarios covering edge cases, tasks are self-contained with concrete acceptance criteria, and no unresolved placeholders remain.
  • Use Case: A product and engineering team has a feature proposal, technical spec, design doc, and implementation task list; use this skill to review all artifacts before development starts to catch misalignments that would cause costly rework later.

Quick Start

Use the review-spec skill to review all design artifacts in the attached project folder for consistency, gaps, and alignment before implementation begins.

Frequently Asked Questions about review-spec

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

FAQPage Schema
How do I check design documents for inconsistencies and gaps before implementation?

Cross-artifact consistency checks identify contradictions, scope drift, and terminology mismatches between linked proposals, specs, and task lists. Requirement and task validation ensures testable scenarios, concrete acceptance criteria, and no unresolved placeholders remain before engineering resources are allocated.

What is pre-implementation spec validation and when do I need it?

Pre-implementation spec validation reviews multiple linked design documents to find untestable requirements, missing features, and misaligned scope. You need it when teams produce proposals, architecture documents, and implementation task lists, preventing costly rework and misaligned deliverables before coding starts.

Can I review multiple linked design artifacts like proposals, specs, and task lists together?

Yes, cross-artifact alignment reviews all linked design documents in a project folder together. It catches dropped items, terminology mismatches, and contradictions between the feature proposal, technical spec, design doc, and implementation task list to ensure full scope alignment.

How do I validate that software requirements have testable acceptance criteria?

Requirement and task validation ensures all requirements have testable scenarios covering edge cases. It verifies that tasks are self-contained with concrete acceptance criteria and checks that no unresolved placeholders remain in the design artifacts before development begins.

What's the best way to catch scope drift between a feature proposal and its technical spec?

Cross-artifact consistency checks compare linked design documents to identify scope drift, dropped items, and contradictions. Reviewing the feature proposal, architecture document, and task list together catches misalignments that would cause wasted implementation effort and rework later.

Do I need a specific framework to perform a design review on my architecture documents?

No specific framework is required. The review applies to standard software development workflows where teams produce multiple linked design documents like proposals, specifications, architecture documents, and implementation task lists to define feature scope and implementation plans.