spec-verifier

Verify specification quality and completeness. Use after writing spec.md to ensure it meets standards before task breakdown - checks for clarity, feasibility, testability, and completeness.

⭐2stars🔀0forks📁View on GitHub🕐Updated Dec 18, 2025⬇️2downloads

When & Why to Use This Skill

The Spec Verifier Claude skill is a specialized quality assurance tool designed to audit technical specification documents for clarity, feasibility, and completeness. By validating spec.md files before the development phase begins, it ensures that requirements are technically sound and testable, preventing costly architectural errors and streamlining the transition from planning to task execution.

Use Cases

  • Pre-Development Audit: Use the skill to verify that a new feature's spec.md is comprehensive and ready for task breakdown, ensuring no critical technical details are missed.
  • Technical Feasibility Check: Leverage the integrated 'oracle' tool to assess whether the proposed specifications are realistic and achievable within the existing codebase.
  • Documentation Standard Alignment: Ensure all project specifications meet organizational standards for testability, dependency awareness, and structural clarity before team handoffs.
namespec-verifier
descriptionVerify specification quality and completeness. Use after writing spec.md to ensure it meets standards before task breakdown - checks for clarity, feasibility, testability, and completeness.

Spec Verifier

Validate specification documents before proceeding to task creation.

When to Use

  • After completing spec.md
  • Before creating tasks.md
  • When reviewing existing specs for quality

Verification Process

  1. Load Checklist

  2. Analyze Spec

    • Read amp-os/specs/[feature]/spec.md
    • Cross-reference with planning/requirements.md
  3. Score Each Category

    • Clarity & Structure
    • Technical Completeness
    • Feasibility
    • Testability
    • Dependency Awareness
  4. Generate Report

    • List passing criteria
    • Flag issues with specific recommendations
    • Provide overall readiness assessment

Output Format

## Spec Verification: [Feature Name]

### ✅ Passing
- [criterion]: [evidence]

### ⚠️ Issues
- [criterion]: [problem] → [recommendation]

### Verdict: READY / NEEDS REVISION

Amp Tools to Use

  • oracle - For complex feasibility analysis
  • finder - Verify referenced code exists