spec-reviewing

Audit SPEC documents for completeness, consistency, and technical quality.

23|2|Updated Jun 9, 2025
One-click install
npx skills add https://github.com/kaptinlin/gozod --skill spec-reviewing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-reviewing
Source: https://github.com/kaptinlin/gozod/tree/main/.agents/skills/spec-reviewing
Command: npx skills add https://github.com/kaptinlin/gozod --skill spec-reviewing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

SPEC documents often drift from defined standards, creating gaps and risks of over-engineering. This skill provides a disciplined review workflow to enforce completeness, consistency, and alignment with reference implementations before moving to implementation.

Core Features & Use Cases

  • Mechanical Review — checks document structure, section presence, and reference validity.
  • Semantic Review — evaluates completeness, consistency, and implementability.
  • Technical Review — flags over-design, vague requirements, and misalignments with reference implementations.
  • SSOT & Consistency — ensures single-source truth across SPECS and terminology alignment.
  • Practical Use Cases — runs reviews after spec batches, before implementation, or after refactors.

Quick Start

Review the latest SPEC documents to identify gaps, inconsistencies, and potential over-engineering.

Frequently Asked Questions about spec-reviewing

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

FAQPage Schema
How do I review SPEC documents for completeness and consistency before implementation?

Spec review checks document completeness and consistency by enforcing mechanical, semantic, and technical audits to identify design gaps, validate single-source truth, and ensure alignment with reference implementations before implementation begins.

What is the best way to audit technical specifications for over-engineering and vague requirements?

Auditing technical specifications for over-engineering requires a technical review that flags vague requirements, identifies misalignments with reference implementations, and enforces explicit decision records to prevent unnecessary design complexity.

When should I run a spec review during the software development lifecycle?

Run a spec review after a batch of specs is written, immediately before implementation begins, or during spec refactors to ensure documents align with spec-writing guides and maintain cross-SPEC consistency.

How does single-source truth (SSOT) consistency work across multiple SPEC documents?

Single-source truth consistency across SPEC documents is enforced through semantic review checks that verify terminology alignment, validate cross-SPEC references, and require explicit decision records to prevent documentation drift.

What checks are needed to validate SPEC document structure and reference validity?

Validating SPEC document structure and reference validity requires a mechanical review that verifies section presence, checks document formatting, and confirms that all cross-references align with defined spec-writing guidelines.

Can I use this spec review workflow to audit documentation after refactoring?

Yes, you can use this spec review workflow to audit documentation after refactoring to verify that updated SPECs maintain completeness, enforce single-source truth, and preserve alignment with reference implementations.