Can I use this for changes that are still in progress?

Absolutely. You can run the verification at any time to see a scorecard of your progress and identify which tasks or requirements are still pending.

How does it determine if a requirement is implemented?

The skill performs keyword analysis, file path investigation, and requirement mapping to find evidence of implementation within the codebase, comparing it against the 'Requirement' blocks in your specs.

Do I need any external tools to use this skill?

Yes, this skill requires the openspec CLI to be installed and available in your environment to fetch change data and artifacts.

What does the 'Coherence' dimension check?

Coherence checks look for consistency with project patterns and adherence to the architectural decisions outlined in your design.md file.

What is OpenSpec Change Verification?

It is a specialized capability for Claude Code that audits your code changes against OpenSpec artifacts like tasks, specs, and design documents to ensure everything is complete and correct.

OpenSpec Change Verification

Name: OpenSpec Change Verification
Author: bcl1713

bybcl1713

0•

Security & Testing

Validates that code implementations align perfectly with specified requirements, design documents, and task lists before archiving changes.

This skill streamlines the pre-archive validation process by comparing your codebase changes against OpenSpec artifacts. It systematically audits three key dimensions—Completeness, Correctness, and Coherence—to ensure every task is finished, every requirement is implemented, and the code adheres to established design patterns. By generating a structured report with actionable recommendations and a priority-based issue list, it helps developers catch missing scenarios or architectural deviations early, ensuring high implementation fidelity and reducing technical debt.

Key Features

01Requirement Mapping: Verifies that every 'Requirement' in the delta specs has a corresponding implementation in the codebase.

02Design Adherence Audit: Compares code structure and logic against architectural decisions documented in design.md.

030 GitHub stars

04Three-Tiered Issue Reporting: Categorizes findings into Critical, Warning, and Suggestion for clear, prioritized fixes.

05Automated Scorecard Generation: Provides a high-level summary of change readiness to accelerate the review and archive process.

06Comprehensive Completeness Checks: Automated parsing of tasks.md to track finished versus unfinished work items.

Use Cases

01Performing a final validation before archiving a code change to ensure all specs and tasks were successfully addressed.

02Conducting self-audits during spec-driven development to maintain high alignment between documentation and code.

03Identifying unimplemented edge cases or scenarios that were defined in the planning phase but missed during coding.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bcl1713/couch-to-5k openspec-verify-change

For use in Claude.ai and ChatGPT

Download Skill