openspec-sync-specs

Synchronize delta specifications from a change into the main project specifications directory.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of merging specification changes from a development branch or feature into the main project specifications, ensuring consistency and reducing manual merge conflicts.

Core Features & Use Cases

  • Delta Spec Synchronization: Propagates new, modified, or removed requirements from a change's delta specs to the main project specs.
  • Intelligent Merging: Applies changes intelligently, preserving existing content and only updating specified requirements or scenarios.
  • Use Case: After developing a new feature, use this Skill to seamlessly integrate its updated requirements into the project's master specification document without manually copying and pasting.

Quick Start

Use the openspec-sync-specs skill to sync specs for the change named 'feature-x'.

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 main project specs?

To merge specification changes, you synchronize delta specifications from your change directory into the main project specifications directory, propagating requirement updates, additions, and removals automatically.

How does intelligent merging handle existing requirements during spec synchronization?

Intelligent merging preserves existing content during spec synchronization and only updates the specified requirements or scenarios from the delta specs, reducing manual merge conflicts.

Do I need the openspec CLI to sync delta specs to the main directory?

Yes, you need the openspec CLI installed to sync delta specs, as the process requires adherence to specific delta spec file formats within the change's directory.

What is the best way to update master specification documents after developing a new feature?

The best way to update master specification documents is using automated delta spec synchronization, which integrates updated requirements without manually copying and pasting content.

Why does spec synchronization fail to apply my changes?

Spec synchronization fails if the delta spec files within the change's directory do not adhere to the specific file formats required by the openspec CLI.

When do I need to sync change specs to main specs?

You need to sync change specs when you want to propagate new, modified, or removed requirements from a development branch into your main project specifications directory for consistency.