openspec-sync-specs

Merge delta spec changes into main specs and output an update log.

45|3|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/Charles5277/nuxt-supabase-starter --skill openspec-sync-specs-charles5277
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/Charles5277/nuxt-supabase-starter/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/Charles5277/nuxt-supabase-starter --skill openspec-sync-specs-charles5277

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta spec synchronization is essential to keep the main specs up to date without archiving every change, reducing duplication and drift.

Core Features & Use Cases

  • Intelligent merging of delta specs into the main specs, preserving changes without overwriting unrelated content.
  • Handles ADDED, MODIFIED, REMOVED, and RENAMED sections with safe, incremental updates.
  • Use case: when you receive a delta spec from a change, merge it into the main spec to reflect the latest requirements without rewriting the entire spec.

Quick Start

Run the openspec CLI to locate delta specs and apply them to the 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 losing existing requirements?

To merge delta specs, apply added, modified, removed, and renamed changes incrementally to the main specs. This preserves unrelated content while reflecting the latest requirements and generating a concise update log summary.

What is delta spec synchronization used for in software engineering?

Delta spec synchronization keeps main specs up to date by merging changes without archiving the original change request. This reduces duplication and drift between evolving requirements and the main specification.

How to safely apply added, modified, and removed requirement changes to a main spec?

Safely applying requirement changes involves validating the delta structure first, then reading both delta and main specs to merge sections incrementally. This prevents overwriting unrelated content while producing an update log.

Does the openspec CLI archive changes when synchronizing delta specs?

No, synchronizing delta specs applies changes to the main specs while explicitly avoiding archiving the original change. This ensures the change request remains available after the merge is complete.

Can I use incremental spec merging for renamed sections without rewriting the entire spec?

Yes, incremental spec merging handles renamed sections safely without rewriting the entire spec. It processes added, modified, removed, and renamed requirements individually to preserve unrelated content in the main specification.