openspec-sync-specs

Merge delta specification changes into main openspec specification files.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Tzeusy/butlers --skill openspec-sync-specs-tzeusy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/Tzeusy/butlers/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/Tzeusy/butlers --skill openspec-sync-specs-tzeusy

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of updating main specification files with changes defined in delta specification files, ensuring consistency and efficient management of evolving requirements.

Core Features & Use Cases

  • Intelligent Merging: Applies changes from delta specs to main specs, handling additions, modifications, removals, and renames of requirements intelligently.
  • Contextual Change Selection: Automatically prompts the user to select a change if not provided, ensuring the correct delta is applied.
  • Use Case: When a new feature is developed, its requirements are documented in a delta spec. This Skill integrates those new requirements into the main specification document without manual copy-pasting or complex merging.

Quick Start

Use the openspec-sync-specs skill to sync changes from the 'feature-x' branch.

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

To merge delta specification files into main specs, use this Skill to intelligently apply additions, modifications, removals, and renames of requirements across different capabilities without manual copy-pasting.

What is the best way to sync requirements from a feature branch to main specifications?

Syncing requirements from a feature branch to main specifications is handled by applying delta spec changes to the main documents, ensuring evolving requirements remain consistent and automatically prompting you to select the correct change.

Do I need the openspec CLI to synchronize specification changes?

Yes, you need the openspec CLI installed, as this Skill requires it to list and manage changes alongside their associated delta specifications before applying the intelligent merge.

Can I automatically remove or rename requirements when syncing delta specs?

Yes, you can automatically remove or rename requirements when syncing delta specs, as the intelligent merging mechanism handles additions, modifications, removals, and renames across different capabilities.

How does contextual change selection work when syncing specifications?

Contextual change selection works by automatically prompting you to select a specific change if one is not explicitly provided, ensuring the correct delta specification is applied to the main document.