spec-review

Review specification documents and apply user-approved corrections for inconsistencies.

Updated May 3, 2026
One-click install
npx skills add https://github.com/ousiass/dotfiles --skill spec-review-ousiass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/ousiass/dotfiles/tree/main/.claude/skills/spec-review
Command: npx skills add https://github.com/ousiass/dotfiles --skill spec-review-ousiass

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you reduce spec drift by reviewing generated specifications and correcting inconsistencies, code mismatches, and documentation quality issues interactively.

Core Features & Use Cases

  • Multi-mode spec review: Run consistency checks, code discrepancy checks, quality checks, or all of them in order.
  • Interactive, one-issue-at-a-time fixes: Present each finding to the user for confirmation, then apply the chosen edit strategy.
  • Cross-references across artifacts: Validate relationships like feature requirements ↔ API specs, ER diagrams ↔ API specs, and components ↔ APIs.

Quick Start

Ask the spec-review skill to review the specs directory in all modes by running it with the path and mode set to "すべて".

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I review generated specification documents for consistency and code divergence?

Review generated specification documents by running multi-mode checks for consistency, code divergence, and quality across feature requirements, API specs, and ER diagrams. The process interactively presents each issue for user-approved corrections.

What is the best way to fix API documentation mismatches against feature requirements?

Fix API documentation mismatches by running interactive consistency checks that cross-reference feature requirements with API specs and ER diagrams. Each identified mismatch is presented individually for confirmation before applying corrections.

Can I validate cross-references between ER diagrams and API specifications interactively?

Yes, you can validate cross-references between ER diagrams and API specifications interactively. The review process checks relationships across multiple doc artifacts and presents each discrepancy one issue at a time for user confirmation.

How do I commit specification document fixes individually after an interactive review?

Commit specification document fixes individually by applying user-approved corrections during the interactive review. The process updates revised documentation with a separate git commit per resolved issue.

What documentation quality checks are available for multi-artifact spec workflows?

Available documentation quality checks for multi-artifact spec workflows include consistency validation, code discrepancy detection, and quality review. These checks can be run individually or all at once in sequence across feature requirements, API specs, and component designs.