openspec-sync-specs

Merge delta specs into main specs with idempotent updates.

2|1|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/Yi-ming-Zhao/Fittin --skill openspec-sync-specs-yi-ming-zhao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/Yi-ming-Zhao/Fittin/tree/main/.cursor/skills/openspec-sync-specs
Command: npx skills add https://github.com/Yi-ming-Zhao/Fittin --skill openspec-sync-specs-yi-ming-zhao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs to keep product specifications up to date without archiving iterations.

Core Features & Use Cases

  • Intelligent delta merging: read delta specs and apply changes to main specs with guardrails to avoid data loss.
  • Interactive change selection: prompts the user to choose which delta set to merge when multiple changes exist.
  • Safe, idempotent updates: updates are applied incrementally and can be repeated without duplicating content.

Quick Start

Run the openspec-sync-specs tool with an optional change name 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 product specifications safely?

To merge delta specs safely, this tool applies changes incrementally with built-in guardrails to prevent data loss. It parses delta changes and updates main specs while strictly preserving existing content structure.

What are delta specs and when do I need to sync them?

Delta specs represent incremental changes made during a development cycle. You need to sync delta specs when you want to apply these iterations to main product specifications without permanently archiving the change history.

How do I choose which changes to merge when multiple delta specs exist?

When multiple changes exist, the merge process prompts you to interactively select a specific delta set. You choose the desired delta change name, and the tool targets only that set for merging.

Can I run spec merges repeatedly without duplicating content?

Yes, you can run merges repeatedly because the updates are strictly idempotent. The tool applies delta changes incrementally, ensuring that repeating the merge operation never duplicates existing specification content.

Does merging delta specs overwrite existing content in main specifications?

Merging delta specs does not overwrite existing content uncontrollably because the tool enforces strict content preservation and guardrails. It safely applies delta parsing to ensure original main spec data remains intact.