review-spec

Parse specs and produce severity-rated review reports with security and testability checks.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/vndkubi/code-graph --skill review-spec-vndkubi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-spec
Source: https://github.com/vndkubi/code-graph/tree/main/.github/skills/review-spec
Command: npx skills add https://github.com/vndkubi/code-graph --skill review-spec-vndkubi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews specs (PRDs, user stories, API contracts, and DB schemas) for completeness, security gaps, testability, ambiguity, and non-functional requirements, producing a structured, actionable review.

Core Features & Use Cases

  • Comprehensive spec quality checks across security, reliability, and non-functional requirements.
  • Produces severity-rated findings and a formal review report ready for stakeholder sign-off.
  • Integrates with existing templates and artifacts to validate completeness and consistency.

Quick Start

Review a spec document by feeding a PRD, API contract, or DB schema to obtain a structured, severity-rated review.

Frequently Asked Questions about review-spec

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

FAQPage Schema
How do I review a PRD for security gaps and completeness?

To review a PRD for security gaps, you parse the spec to enforce security and testability lenses, flag missing sections against templates, and produce a severity-rated review report.

What is the best way to check testability issues in API contracts?

Checking testability issues in API contracts involves applying a structured workflow that parses the contract, enforces testability lenses, and identifies non-functional requirement gaps.

How do I identify missing non-functional requirements in user stories?

Identifying missing non-functional requirements in user stories requires parsing the spec and flagging missing sections against templates to ensure completeness and consistency.

Can I integrate spec review findings into my existing docs workflow?

Yes, you can integrate spec review findings by producing a structured review report suitable for integration with other skills and saving it under docs/reviews.

Does this spec review process work with DB schemas?

Yes, the spec review process works with DB schemas by parsing the schema, enforcing security and testability lenses, and generating a severity-rated review report.