openspec-verify-change

Validate OpenSpec change implementation against specs, tasks, and design artifacts.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/RyanCallahan312/crayon --skill openspec-verify-change-ryancallahan312
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/RyanCallahan312/crayon/tree/main/.opencode/skills/openspec-verify-change
Command: npx skills add https://github.com/RyanCallahan312/crayon --skill openspec-verify-change-ryancallahan312

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates that an OpenSpec change's artifacts (specs, tasks, and design) are fully implemented and coherent before archiving.

Core Features & Use Cases

  • Validate completeness of delta specs (requirements) against code changes.
  • Check correctness by mapping requirements to implementation and test coverage.
  • Assess coherence by verifying design decisions and pattern consistency.

Quick Start

To verify a change, run the skill with the targeted OpenSpec change name and review the generated verification report.

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 changes match OpenSpec specs before archiving?

Verifying OpenSpec changes before archiving requires checking that delta specs in openspec/changes/<name>/specs are fully implemented. The process validates completeness, correctness, and coherence across code, tests, and documentation, producing a report with CRITICAL, WARNING, and SUGGESTION issues.

What is OpenSpec change verification and when do I need it?

OpenSpec change verification is the process of validating that an implementation matches its change artifacts. You need it before archiving changes to ensure specs, tasks, and design documents are fully and correctly implemented without missing requirements.

How do I check delta spec completeness against my code implementation?

Checking delta spec completeness involves mapping requirements from delta specs to your code changes and test coverage. This ensures every requirement in the OpenSpec change artifacts has a corresponding implementation and validates correctness.

Can I validate OpenSpec design coherence and pattern consistency automatically?

You can validate design coherence by assessing design decisions and pattern consistency across the implementation. The skill reviews context files like design.md alongside code and tests to verify coherence before archiving.

What files do I need to run an OpenSpec change validation?

Running OpenSpec change validation requires access to delta specs located in openspec/changes/<name>/specs, along with context files like tasks.md and design.md. These artifacts provide the requirements and design decisions to verify against.

What is the difference between CRITICAL and WARNING issues in a change verification report?

In a change verification report, CRITICAL issues indicate severe failures in matching implementation to specs, while WARNING issues highlight potential inconsistencies. SUGGESTION issues provide recommendations for improving coherence and completeness before archiving.