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.