openspec-verify-change

Verify implementation matches OpenSpec change artifacts before archiving.

Updated Nov 7, 2023
One-click install
npx skills add https://github.com/lstellway/nixfiles --skill openspec-verify-change-lstellway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/lstellway/nixfiles/tree/main/modules/home-manager/claude/skills/openspec-verify-change
Command: npx skills add https://github.com/lstellway/nixfiles --skill openspec-verify-change-lstellway

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before archiving a change in an OpenSpec workflow, teams need confidence that the implementation actually matches the planned specs, tasks, and design decisions. Manually cross-checking code against change artifacts is slow and error-prone, and incomplete work can slip through. ## Core Features & Use Cases - Three-Dimension Verification: Audits completeness (task checkboxes, spec coverage), correctness (requirement implementation, scenario coverage), and coherence (design adherence, code pattern consistency). - Prioritized Issue Reporting: Generates a markdown report with a summary scorecard and issues grouped as CRITICAL, WARNING, or SUGGESTION, each with actionable recommendations and file references. - Graceful Degradation: Adapts verification depth based on available artifacts, verifying only tasks if specs or design documents are missing. - Use Case: After finishing a feature tracked by an OpenSpec change, run verification to confirm all tasks are checked off, every requirement has corresponding code, and the implementation follows the design before archiving the change. ## Quick Start Verify that my current OpenSpec change implementation is complete and ready to archive.

Frequently Asked Questions about openspec-verify-change

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

FAQPage Schema
How do I verify an OpenSpec change before archiving?

Run the verification workflow with a change name, or let it prompt you to select from available changes via openspec list. It checks task completion, spec coverage, and design adherence, then produces a report telling you whether the change is ready to archive.

What does the OpenSpec verification report check?

The report checks three dimensions: completeness (task checkboxes and requirement coverage), correctness (implementation evidence and scenario coverage), and coherence (design decision adherence and code pattern consistency). Issues are grouped as CRITICAL, WARNING, or SUGGESTION.

Does openspec-verify-change work without a design document?

Yes, it degrades gracefully based on available artifacts. With only tasks.md it verifies task completion; with tasks and specs it checks completeness and correctness; design adherence checks are skipped and noted when no design.md exists.

What happens if I don't specify a change name?

The skill runs openspec list --json and prompts you to select a change using an interactive question. It never guesses or auto-selects a change, and marks changes with incomplete tasks as In Progress.

What are the limitations of automated spec verification?

Verification relies on keyword search and reasonable inference rather than perfect certainty, so false positives are possible. To reduce noise, uncertain findings are reported as SUGGESTION or WARNING instead of CRITICAL.