openspec-sync-specs

Merge delta spec changes into openspec main spec files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the manual and error-prone process of applying delta spec changes into canonical specification files, preventing lost edits and inconsistent requirement states across openspec repositories.

Core Features & Use Cases

  • Delta discovery and selection: Lists available changes under openspec/changes and prompts the user to choose a change to apply.
  • Intelligent merging: Adds ADDED requirements, applies MODIFIED changes by appending or updating scenarios, removes REMOVED requirements, and renames requirements for RENAMED entries while preserving unrelated content.
  • Spec creation and summaries: Creates new capability spec files when needed and provides a clear summary of what was added, modified, removed, or renamed for review and audit.
  • Use Case: A product writer has incremental spec edits in a change branch and needs those edits integrated into main specs without overwriting unrelated scenarios.

Quick Start

Apply the named change so its delta specifications are merged into openspec/specs with intelligent adds, updates, removals, and a summary of edits.

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 spec changes into main specs without overwriting unrelated scenarios?

To merge delta spec changes intelligently, you can apply adds, modifies, removes, and renames from change branches into main specs while preserving unrelated content. This ensures scenarios are appended or updated without losing existing edits.

What is the best way to automate openspec requirements updates across change branches?

Automating openspec requirements updates involves reading delta specs and applying changes to canonical specification files. This process handles requirement additions, modifications, deletions, and renames while requiring user selection and confirmation for audit.

How does intelligent merging handle removed and renamed requirements in openspec?

Intelligent merging handles removed requirements by deleting them from main specs and processes renamed requirements by updating their entries. It also adds new requirements and appends or updates scenarios for modified ones, preserving unrelated content.

Can I create new capability spec files when syncing delta specs?

Yes, syncing delta specs can create new capability spec files when needed. It reads changes under openspec/changes and applies them to openspec/specs, generating a clear summary of added, modified, removed, or renamed requirements for review.

Do I need to manually select which delta spec to apply in openspec workflows?

Yes, delta discovery and selection prompts you to choose a specific change to apply from the available options under openspec/changes. This ensures user confirmation before merging delta specifications into the main spec files.

Why does syncing delta specs prevent inconsistent requirement states in openspec?

Syncing delta specs prevents inconsistent requirement states by automating the application of incremental edits into canonical files. This avoids manual errors, lost edits, and ensures all adds, modifies, removes, and renames are accurately reflected.