openspec-sync-specs

Merge delta specs into main specs with ADDED/MODIFIED/REMOVED/RENAMED guidance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

Core Features & Use Cases

  • Intelligent delta merging: reads delta specs and applies to main specs with ADDED/MODIFIED/REMOVED/RENAMED guidance.
  • Interactive change selection: prompts to choose a change when multiple delta specs exist.
  • Safe, idempotent updates: preserves content not mentioned in delta and creates main specs if missing.
  • Use Case: When a delta spec updates the main specs, you can merge to main specs without archiving the change.

Quick Start

Run the openspec sync command to merge active delta specs into main specs.

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 without archiving the change?

Merging delta specs into main specs is done by synchronizing the changes using ADDED, MODIFIED, REMOVED, and RENAMED actions to update core specifications while preserving the original change folder.

What happens if I sync a delta spec but the main spec is missing?

If the main spec is missing during synchronization, the process safely creates the new main spec automatically, ensuring idempotent updates and establishing the core specification from the delta.

How does spec management handle multiple delta specs during a sync?

When multiple delta specs exist, the synchronization process uses interactive change selection, prompting you to choose the correct change to apply, ensuring only intended delta updates merge into the main specs.

Does syncing delta specs overwrite content not mentioned in the change?

Syncing delta specs does not overwrite unmentioned content. The intelligent merge preserves existing main spec content while applying only the specific add, modify, remove, or rename actions from the delta.

When should I use delta spec synchronization for version control?

Use delta spec synchronization when you want to update main specs with changes from a delta spec in a controlled workflow, applying delta-driven updates to core specifications without archiving the original change.