openspec-sync-specs

Merge delta specs into main specification files under openspec/changes.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/nuomi1/vCalendar --skill openspec-sync-specs-nuomi1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/nuomi1/vCalendar/tree/main/.opencode/skills/openspec-sync-specs
Command: npx skills add https://github.com/nuomi1/vCalendar --skill openspec-sync-specs-nuomi1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs into the main specs to keep documentation and requirements up-to-date without manual, error-prone edits.

Core Features & Use Cases

  • Delta-driven merging: reads delta specs and updates main specs with added, modified, removed, or renamed requirements.
  • Intelligent merging: preserves unrelated content and creates missing main specs on demand.
  • Operational workflow: navigates openspec/changes/<name>/specs to apply changes and generate a summary.
  • Use Case: teams wanting to propagate approved delta changes into main specs during release cycles.

Quick Start

Select a delta change and run the delta-merge workflow to 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 specs into main specs automatically?

To merge delta specs into main specs, the tool reads delta changes under openspec/changes and applies ADDED, MODIFIED, REMOVED, and RENAMED requirements to the corresponding main specification files. It preserves existing content and creates missing main specs on demand.

What is the best way to synchronize requirements without losing existing content?

Synchronizing requirements without losing existing content is achieved through intelligent delta-driven merging, which applies only the specified changes from delta specs while preserving all unrelated content in the main specification files.

How does delta-to-main spec synchronization handle renamed requirements?

Delta-to-main spec synchronization handles renamed requirements by reading the RENAMED delta changes and applying them directly to the corresponding main specification files, ensuring the requirements stay current without manual edits.

Can I automatically create missing main specs when applying delta changes?

Yes, you can automatically create missing main specs when applying delta changes. The merging process creates the necessary main specification files on demand if they do not already exist in the target directory.

What are the limitations of automated spec merging for release cycles?

The limitations of automated spec merging include its strict operation on delta sets located specifically under openspec/changes/<name>/specs, meaning it cannot process requirements outside this delta structure or handle unsupported change types.