spec-review

Validate software implementation against OpenSpec design documents and task lists.

1|Updated Dec 14, 2025
One-click install
npx skills add https://github.com/komluk/scaffolding.template --skill spec-review-komluk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-review
Source: https://github.com/komluk/scaffolding.template/tree/main/stacks/_common/.claude/skills/spec-review
Command: npx skills add https://github.com/komluk/scaffolding.template --skill spec-review-komluk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill ensures that software implementations accurately adhere to their specified design documents and task lists, preventing costly deviations and ensuring project requirements are met.

Core Features & Use Cases

  • Completeness Check: Verifies all tasks are completed and requirements are covered.
  • Correctness Check: Assesses if the code functions as described in the specifications and handles edge cases.
  • Coherence Check: Evaluates if the implementation aligns with design decisions and architectural patterns.
  • Use Case: After a developer completes a feature, this Skill can be used to automatically audit the code against the design.md and tasks.md files to ensure everything is implemented as intended before code review.

Quick Start

Use the spec-review skill to verify the implementation against the specifications located in the .scaffolding/conversations/12345678-1234-1234-1234-1234567890ab/specs/ directory.

Frequently Asked Questions about spec-review

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

FAQPage Schema
How do I verify code implementation against design specifications?

To verify code implementation against design specifications, you can audit the codebase against OpenSpec artifacts like design and task lists. This checks completeness, correctness, and coherence to identify deviations from specified requirements.

What is an implementation audit for software engineering projects?

An implementation audit validates software code against design documents and task lists. It scopes verification across completeness, correctness, and coherence dimensions to ensure adherence to specified requirements and scenarios.

How do I check if all tasks and requirements are completed in my codebase?

To check if all tasks and requirements are completed, perform a completeness verification against your task lists. This ensures every specified requirement is covered and implemented before formal code review.

Can I assess code correctness and edge case handling using markdown specifications?

Yes, you can assess code correctness by parsing markdown specification files and analyzing the codebase. This evaluates if the code functions as described and handles edge cases according to the design documents.

Does implementation verification work with OpenSpec artifacts?

Yes, implementation verification works directly with OpenSpec artifacts. It parses markdown files from the specs directory to generate a detailed verification report covering completeness, correctness, and coherence.

What are the limitations of automated specification compliance checks?

Automated specification compliance checks require parsing markdown files and codebase analysis to generate reports. They depend on the quality of existing design documents and task lists to identify deviations accurately.