spec-review

Audits project specifications for inconsistencies and drafts correction proposals.

4|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/dmitriyb/spexmachina --skill spec-review-dmitriyb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/dmitriyb/spexmachina/tree/main/skills/spec-review
Command: npx skills add https://github.com/dmitriyb/spexmachina --skill spec-review-dmitriyb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, and includes scripts (resource) components.

What problem does it solve?

This Skill audits specifications for internal inconsistencies and drafts correction proposals, streamlining the process of maintaining and updating project specifications.

Core Features & Use Cases

  • Spec Consistency Audit: Identifies internal inconsistencies within specifications, such as contradictions between prose and JSON declarations.
  • Proposal Drafting: Automatically drafts correction proposals in plan mode if inconsistencies are found.
  • Use Case: When reviewing a large project specification, this Skill can quickly pinpoint discrepancies and generate a detailed correction proposal for review and implementation.

Quick Start

Run the spec-review skill on a specific module or the entire spec to check for inconsistencies and generate a correction proposal.

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I audit specifications for internal inconsistencies?

Automated spec consistency checking identifies contradictions between prose and JSON declarations within project specifications. It scans for mismatches and drafts detailed correction proposals to resolve the discrepancies.

How do I draft correction proposals for specification contradictions?

Drafting correction proposals is handled automatically in plan mode when inconsistencies are found during an audit. The tool generates a detailed proposal outlining the necessary corrections for your project specification.

Do I need Python to check spec consistency?

Yes, you need Python installed to check spec consistency. The auditing process relies on Python for scripting the detection of contradictions between prose and JSON declarations, alongside Markdown for documentation.

What is the best way to find contradictions between prose and JSON declarations?

The best way to find contradictions between prose and JSON declarations is using an automated consistency audit. It systematically compares the text and data structures to pinpoint discrepancies and output a correction proposal.

Can I review a specific module for spec inconsistencies?

Yes, you can review a specific module for spec inconsistencies. The audit can be run on a targeted module or the entire project specification to quickly pinpoint discrepancies and generate a correction proposal.