openspec-sync-specs

Merge delta specification changes into main specifications using openspec CLI.

5|2|Updated Oct 2, 2025
One-click install
npx skills add https://github.com/syifan/cgra-flow-ui --skill openspec-sync-specs-syifan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/syifan/cgra-flow-ui/tree/main/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/syifan/cgra-flow-ui --skill openspec-sync-specs-syifan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures that main specs are kept up-to-date with changes from delta specs, facilitating seamless integration of updates without archiving the change.

Core Features & Use Cases

  • Sync Delta Specs: Update main specs with changes from delta specs, allowing intelligent merging of requirements.
  • Agent-Driven Operation: Directly edit main specs to apply changes from delta specs.
  • User Selection of Changes: Optionally specify a change name, or select from available changes if not provided.
  • Intelligent Merging: Apply changes like adding scenarios without copying existing ones, preserving content not mentioned in delta.

Quick Start

Run the openspec-sync-specs skill to sync delta specs from the 'main' change.

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 specification changes into main specs?

To merge delta specifications into main specs, use an automated sync tool that intelligently applies updates to requirements without duplicating existing scenarios. This process ensures seamless integration of software changes while preserving original content.

What is a delta specification in requirements management?

A delta specification in requirements management represents incremental changes to be applied to main specs. It allows adding, modifying, or removing specific requirements without rewriting the entire document or archiving the change.

Do I need the openspec CLI to sync specifications?

Yes, you need the openspec CLI installed to handle specification sync and change management. The tool relies on the CLI to read available changes and apply delta updates to your main requirements intelligently.

How do I update main specs with delta changes without losing existing content?

To update main specs with delta changes without losing existing content, use intelligent merging. This applies delta updates by adding new scenarios without copying existing ones, preserving main spec content not explicitly mentioned in the delta.

Can I select a specific change name when syncing specifications?

Yes, you can optionally specify a change name when syncing specifications. If no change is provided, the tool will prompt you to select from available changes detected in your environment to apply the delta updates.

What's the best way to manage incremental software requirement updates?

The best way to manage incremental software requirement updates is using a delta specification sync approach. It merges changes into main specs intelligently, facilitating seamless integration while keeping the main specifications continuously up-to-date.