openspec-verify-change

Validates OpenSpec change proposals through five independent review layers before implementation.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill openspec-verify-change-pavelvdo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-verify-change
Source: https://github.com/pavelvdo/universal-xml-exchange2/tree/main/.cursor/skills/openspec-verify-change
Command: npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill openspec-verify-change-pavelvdo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before running implementation on an OpenSpec change request (ZNИ), teams need an independent quality gate that confirms the proposal, design, tasks, and specs are coherent, traceable, and actually implementable — this Skill answers the question "can I safely run apply?" with a clear verdict. ## Core Features & Use Cases - Five-layer verification pipeline: Hygiene auto-fixes, Internal Coherence (quality controller + code-truth grep), Loop Detection for acceptance cycles, Problem-Solution Trace (Why → Requirements → Scenarios → Slices → Tasks), Independent Challenge (adversarial architect audit), and Implementation Readiness. - Binary GO/NO-GO verdict with chat-friendly output: Internal layer statuses are translated into plain verdict-card language for the user, with decision cards when a fork requires user choice and a silent re-run filter when nothing changed since the last report. - Depth modes and repair loop: Supports full, incremental, and lite verification depths with guardrails, plus an internal repair loop that fixes deterministic spec gaps without user interruption. - Use Case: A 1C developer finishes drafting a change with /opsx:new and runs /opsx:verify <name>; the skill checks slice coherence, runs an adversarial design challenge, auto-fixes checkbox hygiene, and returns "можно запускать apply" with a dated verification report. ## Quick Start Ask the assistant to verify an OpenSpec change by name, for example: run /opsx:verify on my change to check whether it is safe to start implementation.

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 implementation?

Run /opsx:verify with the change name. The skill loads the proposal, design, tasks, and specs, then runs five review layers and returns a verdict telling you whether it is safe to run /opsx:apply.

What does the five-layer verification check in OpenSpec?

Layer 1 auto-fixes hygiene issues like missing checkboxes, Layer 2 checks internal coherence and code-truth, Layer 2.5 detects acceptance loops, Layer 3 traces problem to solution, Layer 4 runs an adversarial design challenge, and Layer 5 confirms tasks are implementable as written.

Does openspec-verify-change require the openspec CLI?

Yes, the skill requires the openspec CLI to list and select active changes. It reads change artifacts from the openspec/changes directory and writes verification reports there.

When is the independent design challenge skipped during verification?

Layer 4 is skipped when design.md has not changed since the last successful challenge, when verify depth is lite, or when a valid .gate-override.yaml file defers it for up to seven days. The first verification of a change always runs the full challenge.

Why does verification return NO-GO for my change?

NO-GO results from a FAIL in coherence, loop detection, problem-solution trace, or readiness layers, or a CHALLENGE/REJECT verdict from the adversarial design audit. The report explains the blocking issue and the decision or fix needed before re-running verify.

Can verification fix problems in the proposal automatically?

Yes, deterministic gaps are handled by an internal repair loop that rewrites parts of the spec without user interaction, with up to two attempts. Substantive scope changes still require the user to run /opsx:extend explicitly.