openspec-verify-change

Verify codebase implementations against openspec change artifacts and generate prioritized reports.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/futuretea/x-project --skill openspec-verify-change-futuretea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/futuretea/x-project/tree/main/.claude/skills/openspec-verify-change
Command: npx skills add https://github.com/futuretea/x-project --skill openspec-verify-change-futuretea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill verifies that a codebase implementation matches the declared change artifacts (tasks, delta specs, and design), helping teams avoid premature archiving of incomplete or divergent work and ensuring traceability from requirements to code.

Core Features & Use Cases

  • Automated change discovery: Uses the openspec CLI to list available changes and requires explicit user selection to avoid guessing.
  • Multi-dimension verification: Evaluates Completeness (task checklist and spec requirements), Correctness (requirement-to-code mapping and scenario coverage), and Coherence (design adherence and pattern consistency) with prioritized CRITICAL/WARNING/SUGGESTION issues.
  • Graceful degradation: Runs partial checks when only some artifacts exist (e.g., tasks.md only) and reports which checks were skipped with reasons.
  • Use Case: Use this Skill before closing a change to produce an actionable verification report that lists incomplete tasks, missing requirement implementations, and recommended fixes with file references where available.

Quick Start

Use the openspec CLI to list changes, choose the target change, and run the verification flow to generate a prioritized report for completeness, correctness, and coherence.

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 code implementation matches change specs before archiving?

Change verification validates that an implementation matches declared change artifacts for completeness, correctness, and coherence. It checks task completion, requirement coverage, and design adherence to produce a prioritized verification report before archiving.

What is spec-driven change verification and how does it work?

Spec-driven change verification evaluates change sets containing tasks, delta specs, and design artifacts. It parses tasks.md and specs to check task completion and requirement-to-code mapping, generating prioritized CRITICAL, WARNING, and SUGGESTION issues.

Can I verify a change set if I only have a tasks.md file and missing design artifacts?

Change verification supports graceful degradation when only some artifacts exist. It runs partial checks on available artifacts like tasks.md, reports which checks were skipped, and provides reasons for any skipped verification dimensions.

How do I use the openspec CLI to list and select changes for verification?

Change verification uses the openspec CLI to list available changes and requires explicit user selection to avoid guessing. After choosing a target change, it fetches change context and contextFiles to run the verification flow.

What dimensions are evaluated during change implementation verification?

Change verification evaluates three dimensions: Completeness for task checklists and spec requirements, Correctness for requirement-to-code mapping and scenario coverage, and Coherence for design adherence and pattern consistency.

What is the best way to avoid premature archiving of incomplete code changes?

Change verification prevents premature archiving by checking implementation traceability from requirements to code. It produces an actionable report listing incomplete tasks, missing requirement implementations, and recommended fixes with file references before closing a change.