openspec-sync-specs

Merges delta specs into OpenCV main specs while preserving existing content.

2|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/tonysyu/gqlxp --skill openspec-sync-specs-tonysyu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/tonysyu/gqlxp/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/tonysyu/gqlxp --skill openspec-sync-specs-tonysyu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta/spec merging for OpenSpec repositories, enabling safe, incremental updates from delta specs into the canonical main specs without manual rework.

Core Features & Use Cases

  • Agent-driven delta synchronization that reads delta specs, locates corresponding main specs, and applies changes intelligently.
  • Intelligent merging that handles ADDED, MODIFIED, REMOVED, and RENAMED requirements while preserving unrelated content.
  • Idempotent updates with create-if-missing support and an auditable summary of changes.

Quick Start

Run the delta sync for a chosen change to update main specs with the delta.

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 for OpenSpec?

To merge delta specs into main specs for OpenSpec, you run a delta synchronization process that reads both files, applies changes intelligently, and preserves unrelated existing content in the canonical main specs.

What is delta spec synchronization and when do I need it?

Delta spec synchronization applies incremental changes from delta specs into canonical main specs. You need it to safely update requirements without manual rework or overwriting unrelated content in OpenSpec repositories.

Can I apply idempotent updates to modify or remove requirements in OpenSpec?

Yes, you can apply idempotent updates to add, modify, remove, or rename requirements in OpenSpec. Running the delta sync multiple times yields the same result without duplicating changes or corrupting existing content.

Does delta spec merging support create-if-missing for new requirements?

Yes, delta spec merging supports create-if-missing functionality. When a corresponding main spec is not found, the synchronization process can create the missing file and apply the delta changes directly to it.

How do I track changes after syncing delta specs into main specs?

You can track changes after syncing delta specs by reviewing the auditable summary of changes. The synchronization process reports a concise summary detailing all updates applied to the main specs.

What are the limitations of automated delta spec merging?

Automated delta spec merging is limited to handling ADDED, MODIFIED, REMOVED, and RENAMED requirements. It focuses on preserving unrelated content but may not resolve complex semantic conflicts that require manual review.