openspec-verify-change

Verify implementation completeness, correctness, and coherence against OpenSpec change artifacts.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill openspec-verify-change-capella-hotel-group
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/capella-hotel-group/capella-hotel-group-poc/tree/main/.github/skills/openspec-verify-change
Command: npx skills add https://github.com/capella-hotel-group/capella-hotel-group-poc --skill openspec-verify-change-capella-hotel-group

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before archiving a spec-driven change, teams need confidence that the implementation actually matches the planned specs, tasks, and design decisions. This Skill automates that audit by cross-checking code against OpenSpec change artifacts and producing a structured verification report. ## Core Features & Use Cases - Three-Dimension Verification: Evaluates Completeness (task checkboxes, spec coverage), Correctness (requirement implementation, scenario coverage), and Coherence (design adherence, code pattern consistency). - Prioritized Issue Report: Generates a markdown scorecard grouping findings into CRITICAL, WARNING, and SUGGESTION issues, each with actionable recommendations and file references. - Graceful Degradation: Adapts verification depth based on available artifacts, verifying only tasks when specs or design docs are missing. - Use Case: After finishing implementation of an OpenSpec change, run verification to confirm all tasks are checked off, every requirement has corresponding code, and the design decisions were followed 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, requirement coverage, and design adherence, then outputs 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 spec 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.md file?▼

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 is only verified when design.md exists, and skipped checks are noted.

What are the requirements to run OpenSpec change verification?▼

You need the openspec CLI installed and a project using OpenSpec change artifacts under openspec/changes. The skill runs commands like openspec list, openspec status, and openspec instructions apply to load the change context.

Why does verification report false positives on requirement coverage?▼

Correctness checks use keyword search and reasonable inference rather than exact proof, so uncertainty can occur. The skill mitigates this by preferring SUGGESTION over WARNING and WARNING over CRITICAL when evidence is ambiguous.