gza-spec-review

Validate spec file claims against the current codebase and project structure.

11|1|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/mhawthorne/gza --skill gza-spec-review
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gza-spec-review
Source: https://github.com/mhawthorne/gza/tree/main/src/gza/skills/gza-spec-review
Command: npx skills add https://github.com/mhawthorne/gza --skill gza-spec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams validate specs before implementation by running a structured quality gate that yields a clear go/no-go recommendation.

Core Features & Use Cases

  • Interactive quality gate that checks scope, accuracy, acceptance criteria, and risks.
  • Verifies claims against the codebase (files, commands, config fields) and surfaces issues for revision.
  • Provides a structured output with recommended actions and follow-up tasks for implementation planning.

Quick Start

Provide the path to the spec file when prompted (e.g., specs/foo.md) to begin the interactive gate.

Frequently Asked Questions about gza-spec-review

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

FAQPage Schema
How do I validate a spec file against my codebase before implementation?▼

Spec validation cross-references file existence, CLI flags, config fields, and workflow steps against your codebase to verify accuracy and surface issues before implementation begins.

What is a go/no-go quality gate in software specification review?▼

A go/no-go quality gate analyzes spec claims against the current codebase, returning a structured assessment with recommended actions and follow-up tasks for implementation planning.

How do I check if my spec's acceptance criteria match existing project structure?▼

Run an interactive review that verifies file existence, commands, config fields, and code references to ensure traceable validation of acceptance criteria against the current project structure.

Can I review development specs for scope and risks before coding starts?▼

Yes, providing the path to your spec file triggers an interactive quality gate that checks scope, accuracy, acceptance criteria, and risks to validate specifications before coding starts.

What does a structured spec assessment include for implementation planning?▼

A structured spec assessment includes a go/no-go recommendation, verified file and command cross-references, surfaced issues for revision, recommended actions, and follow-up tasks for implementation planning.

When do I need a spec quality gate in my development workflow?▼

You need a spec quality gate when early specification validation is required in your development workflow, ensuring claims are traceable against the codebase before committing to implementation.