spec-review

Validate codebase coverage against a product requirements document with drift analysis.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill spec-review-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/spec-review
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill spec-review-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams often lose alignment between the product requirements document (PRD) and the actual code, leading to missing features, unintended functionality, and scope creep. This skill continuously validates the implementation against the spec, highlights gaps, and detects changes over time.

Core Features & Use Cases

  • Baseline Specification Parsing: Reads a PRD file or URL, decomposes it into atomic, testable requirements.
  • Drift Detection: Compares new specifications with previously stored versions to identify added, removed, or altered requirements.
  • Coverage Scanning: Uses search hints to scan the codebase, classifying each requirement as implemented, partial, missing, or extra, and produces a detailed coverage report.
  • Actionable Reporting: Generates visual coverage percentages, gap lists, and logs decisions for future reference.

Quick Start

Use the spec-review skill to compare the current codebase against the PRD located at 'docs/spec.md'.

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I check my codebase against product requirements for coverage gaps?

To check codebase coverage, the skill parses a PRD file or URL into atomic requirements, scans source files, and classifies each requirement as implemented, partial, missing, or extra. This generates a detailed coverage report highlighting gaps between the spec and the actual code.

What is spec drift detection and how does it work?

Spec drift detection identifies added, removed, or altered requirements by comparing new specifications with previously stored versions. It continuously validates implementation against the spec to prevent unintended functionality and scope creep over time.

How do I validate implementation against a PRD document?

Validating implementation against a PRD involves decomposing the document into testable requirements, scanning the codebase using search hints, and logging decisions. It produces actionable reports with visual coverage percentages and gap lists for future reference.

Does spec review require specific file tools to parse source files?

Spec review requires read, grep, glob, and write tools to function. These tools are necessary to parse specifications, scan source files within the codebase, and generate the final coverage report with drift analysis.

Can I use a URL to provide a product requirements document for coverage scanning?

Yes, you can provide a PRD via a file path or a URL. The skill reads the baseline specification from the provided source, decomposes it into atomic requirements, and proceeds with codebase scanning and coverage classification.

What is the best way to prevent scope creep in software development?

Preventing scope creep requires continuously validating implementation against the spec to detect extra or changed requirements. By comparing current code against a baseline PRD and generating a coverage report, teams can identify unintended functionality and maintain strict alignment.