openspec-sync-specs

Merge openspec delta requirements into main capability specs in place.

Updated Jul 6, 2025
One-click install
npx skills add https://github.com/wishx127/mirror-server --skill openspec-sync-specs-wishx127
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/wishx127/mirror-server/tree/main/.codebuddy/skills/openspec-sync-specs
Command: npx skills add https://github.com/wishx127/mirror-server --skill openspec-sync-specs-wishx127

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual effort of merging active change deltas into the main spec set, so spec updates stay accurate and consistent without archiving the change too early.

Core Features & Use Cases

  • Delta-to-main merging: Applies added, modified, removed, and renamed requirements from a change directly into the canonical spec files.
  • Intelligent partial updates: Preserves existing scenarios and content while inserting only the intended deltas, which is ideal for incremental spec revisions.
  • Selection-driven workflow: Prompts for a change when needed, reads the relevant delta specs, and updates the matching capability specs in place.

Quick Start

Ask the openspec-sync-specs skill to sync the selected change into the main specs.

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 openspec delta specs into main specs without archiving the change?

To merge openspec delta specs into main specs without archiving, you select an active change and apply added, modified, removed, and renamed requirements directly into the canonical spec files in place.

How does partial spec synchronization handle existing scenarios during updates?

Partial spec synchronization intelligently merges delta updates while preserving existing scenarios and content in the main specs, inserting only the intended changes for incremental spec revisions.

Can I update openspec requirements in place without losing existing spec scenarios?

Yes, updating openspec requirements in place preserves existing scenarios by reading both delta and main specs, intelligently merging partial updates without overwriting unchanged content.

What is the best way to apply renamed or removed requirements from a delta spec to the main spec?

The best way to apply renamed or removed requirements is using a selection-driven workflow that reads the relevant delta specs and updates matching capability specs directly in place.

Do I need the openspec CLI to discover available changes before syncing specs?

Yes, the openspec CLI is used to discover available changes, prompting for a change selection when needed before reading delta specs and updating the matching main capability specs.