skills.rest
g1331
g1331COMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specs into main specs with idempotent, non-destructive updates via openspec CLI validation.

3|Updated Nov 25, 2025
Search Tags:#automation#synchronization#cli#merge#spec#openspec#delta
One-click install
npx skills add https://github.com/g1331/AutoRouter --skill openspec-sync-specs-g1331
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/g1331/AutoRouter/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/g1331/AutoRouter --skill openspec-sync-specs-g1331

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. This enables updating main specs with changes from delta specs while preserving history and avoiding archiving the delta until implementation is complete.

Core Features & Use Cases

  • Intelligent merging of added, modified, removed, and renamed requirements into main specs without wholesale replacement.
  • Delta-driven workflow: reads delta specs from openspec/changes and applies changes to openspec/specs.
  • Idempotent operation: repeated runs produce the same result and safe reconciliation.

Quick Start

Run the openspec sync command to merge delta specs into 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?▼

Synchronizing delta specs intelligently merges added, modified, removed, and renamed requirements into main specs without wholesale replacement. It preserves existing content and applies non-destructive updates to keep your specification history intact.

What is a delta spec workflow for updating software specifications?▼

A delta spec workflow captures changes separately from main specs. This skill reads delta specs from openspec/changes and applies them to openspec/specs, allowing you to update specifications while preserving history until implementation is complete.

Can I run spec synchronization multiple times without creating duplicate changes?▼

Yes, spec synchronization is idempotent. Repeated runs produce the same result and safely reconcile delta specs with main specs, ensuring that running the merge multiple times does not create duplicate or conflicting requirement entries.

Does openspec validate delta specs before merging them into the main specs?▼

Yes, the openspec CLI validates delta spec inputs before applying changes. This ensures that only properly formatted delta specs are merged into the main specs, preventing invalid requirement modifications from being introduced.

How do I handle multiple delta specs for a single capability during synchronization?▼

Synchronizing multiple delta specs per capability is supported natively. The merge process reads all applicable delta specs and sequentially applies added, modified, removed, and renamed requirements to the corresponding main spec.

Related Skills

Explore More Software Engineering Skills→
remiverdiesenremiverdiesen
6

openspec-bulk-archive-change

Archive completed OpenSpec changes into the archive directory.

Community
Advanced
Alan-TheGentlemanAlan-TheGentleman
10

sdd-archive

Merge delta specs into main specs and archive completed changes.

Community
Advanced
belingudbelingud
30

openspec-archive-change

Archive completed OpenSpec changes with verified artifacts and delta specs.

Community
Advanced
cenmiaocenmiao

openspec-sync-specs

Merge delta spec changes into main specification files.

Community
Advanced