openspec-sync-specs

Merge delta spec changes into main specs under openspec/changes.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs into the main spec set by applying delta edits to the base specifications, enabling incremental updates without archiving the delta.

Core Features & Use Cases

  • Intelligent delta merging: applies delta edits to existing main specs or creates new main specs when missing.
  • Delta-driven updates: reads delta specs under openspec/changes/<name>/specs and updates main specs while preserving unrelated content.
  • Idempotent and safe: repeated runs produce the same result and include conflict checks.
  • Use cases include merging delta changes into main specs, handling schema evolutions, and incremental spec maintenance.

Quick Start

Run the delta-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 spec changes into main specs without losing existing content?

Delta merging applies delta edits to base specifications while preserving unrelated content. It reads delta scopes under openspec/changes and updates main specs accordingly, creating new specs only when missing.

What is intelligent delta merging for incremental specification updates?

Intelligent delta merging is the process of syncing delta spec edits into a main spec set. It enables incremental updates by applying targeted changes to base specifications without archiving the original delta files.

Can I run delta spec synchronization repeatedly without creating duplicate edits?

Delta spec synchronization is idempotent, meaning repeated runs produce the exact same result. It enforces conflict checks during updates to ensure safe, repeatable merging operations.

How do I handle schema evolutions in OpenSpec using delta-driven updates?

Delta-driven updates apply schema evolutions by reading delta specs under openspec/changes and updating main specs. This incremental approach maintains existing content while integrating the new schema changes.

Does delta spec merging work when the target main spec does not exist yet?

Yes, delta spec merging supports creating new main specs when they are missing. It applies delta edits to existing specs or generates new base specifications as needed to fulfill the delta requirements.

What's the best way to automate spec maintenance for incremental OpenSpec changes?

Automated delta syncing merges delta spec changes into main specs by running a dedicated sync command. This handles incremental spec maintenance safely through idempotent updates and automated conflict checks.