openspec-sync-specs

Synchronize delta OpenSpec requirement changes into main spec files.

6|1|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/ilaziness/vexo --skill openspec-sync-specs-ilaziness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/ilaziness/vexo/tree/main/.crush/skills/openspec-sync-specs
Command: npx skills add https://github.com/ilaziness/vexo --skill openspec-sync-specs-ilaziness

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of keeping your main OpenSpec requirements up to date when changes are produced in separate “delta” spec files, without losing existing content or needing to rewrite whole specs.

Core Features & Use Cases

  • Delta-to-main synchronization: Applies ADDED, MODIFIED, REMOVED, and RENAMED requirements from a selected change into the corresponding main spec files.
  • Intelligent partial updates: Preserves main-spec scenarios and sections not mentioned in the delta, so merges are focused and non-destructive.
  • New capability support: Creates missing main spec files for capabilities that do not yet exist, adding at least the Purpose and Requirements.

Quick Start

Run the openspec-sync-specs skill to sync delta specs from a named change (or let it prompt you to select one) and update the main specs accordingly.

Frequently Asked Questions about openspec-sync-specs

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

FAQPage Schema
How do I merge delta spec changes into main requirements without losing existing scenarios?

Spec synchronization merges delta changes into main specs by applying added, modified, removed, and renamed requirements while preserving existing main-spec scenarios not mentioned in the deltas.

What is delta-to-main spec synchronization in requirements management?

Delta-to-main synchronization applies targeted changes from separate delta spec files into corresponding main spec files, avoiding the need for full spec replacement or rewriting.

How do I apply added, modified, and removed requirements from a change file to a main spec?

Run the synchronization skill to read both delta and main specs, intelligently applying requirement modifications. It prompts you to choose a specific change if the target is ambiguous.

Can I create new capability spec files when syncing delta requirements?

Yes, synchronizing delta specs creates missing main spec files for capabilities that do not yet exist, automatically adding at least the Purpose and Requirements sections for the new capability.

Is spec synchronization idempotent for repeated delta merge runs?

Yes, the delta merge process behaves idempotently across repeated runs, ensuring that applying the same requirement changes multiple times yields consistent main spec results without duplication.