openspec-sync-specs

Merge delta specification changes into main spec files using the openspec CLI.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/kuchida1981/discord-service-gateway --skill openspec-sync-specs-kuchida1981
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/kuchida1981/discord-service-gateway/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/kuchida1981/discord-service-gateway --skill openspec-sync-specs-kuchida1981

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you merge delta specification changes into the main spec set without archiving the change, reducing manual copy-paste and keeping requirements consistent.

Core Features & Use Cases

  • Delta-to-Main Syncing: Reads change specs and applies added, modified, removed, and renamed requirements into the corresponding main specs.
  • Intelligent Merging: Preserves existing content while updating only the parts requested by the delta, including partial scenario additions.
  • Workflow Guidance: Prompts for a change selection when needed, then summarizes exactly what was updated after the merge.
  • Use Case: A product or engineering team can update a feature spec from an active change branch without losing prior scenarios or duplicating requirements.

Quick Start

Ask the Skill to sync a named change into the main specs, or list available changes if you do not know which one to apply.

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 spec files without archiving?

To merge delta specification changes without archiving, apply the delta specs directly to your main specification files to add, modify, remove, or rename requirements idempotently while preserving existing content.

Does spec syncing require the openspec CLI to apply changes?

Yes, applying delta specification changes to main specification files requires the openspec CLI, which reads both delta and main spec files to merge changes idempotently.

How do I update a feature spec from an active change branch without losing prior scenarios?

Update a feature spec from an active change branch by applying delta specifications through an intelligent merge that preserves existing content and scenarios while updating only the requested parts.

What happens to existing requirements when I sync a delta spec into the main documents?

When you sync a delta spec into the main documents, existing requirements and content are preserved while only the parts requested by the delta are updated, preventing duplication or loss of prior scenarios.

Can I partially add scenarios to a capability-level document using delta specs?

Yes, you can partially add scenarios to a capability-level document because the intelligent merge process supports partial scenario additions alongside requirement modifications and renames.

How do I know which changes are available to sync into the main specs?

To know which changes are available, you can prompt the workflow to list available changes if you do not know which one to apply, and it will prompt for a change selection when needed.