openspec-sync-specs

Merge delta specification changes into main specs using the openspec CLI.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/tuliopc23/cardmaniacs-website --skill openspec-sync-specs-tuliopc23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/tuliopc23/cardmaniacs-website/tree/main/.augment/skills/openspec-sync-specs
Command: npx skills add https://github.com/tuliopc23/cardmaniacs-website --skill openspec-sync-specs-tuliopc23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of updating main specifications with changes from delta specifications, allowing for intelligent merging of requirements without manual copy-pasting.

Core Features & Use Cases

  • Intelligent Merging: Applies added, modified, removed, and renamed requirements selectively.
  • Contextual Input: Infers or prompts for the specific change to sync.
  • Use Case: A product team is iterating on a feature. They use a delta spec to add a new scenario to an existing requirement. This Skill applies only that new scenario to the main spec, preserving all other details.

Quick Start

Use the openspec-sync-specs skill to sync the changes from the 'add-new-feature' branch to the main specifications.

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 specification changes from a feature branch into a main spec?

To merge specification changes into a main spec, apply added, modified, removed, and renamed requirements selectively from a delta spec. This syncs evolving product requirements without manual copy-pasting, preserving all existing unaffected details in the main file.

What is a delta spec and when do I need it for version control of requirements?

A delta spec is a structured file capturing iterative changes to product requirements. You need it when evolving feature specifications on a separate branch, allowing you to isolate modifications before synchronizing them back into the main specification document.

How to sync updated requirements with openspec without overwriting existing scenarios?

Sync updated requirements by running the openspec-sync-specs process, which intelligently merges delta changes into the main spec. It applies only the new or modified scenarios from your branch, preserving all other existing details within the target requirement.

Do I need the openspec CLI to synchronize specifications between branches?

Yes, you need the openspec CLI installed to synchronize specifications between branches. The CLI is required to list and manage specification deltas and main files, providing the contextual input needed to apply the targeted requirement changes.

Can I selectively apply removed or renamed requirements when syncing specs?

Yes, you can selectively apply removed or renamed requirements when syncing specs. The intelligent merging process supports applying added, modified, removed, and renamed requirement changes individually from the delta spec to the main specification.

What is the best way to manage evolving product specifications across a team?

The best way to manage evolving product specifications is using a structured documentation system with openspec. Teams iterate using delta specs for feature changes, then sync only those specific requirement modifications back to the main spec, avoiding manual merge conflicts.