skills.rest
crozzbite
crozzbiteCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specs into main specs using the openspec CLI.

Updated May 29, 2025
Search Tags:#automation#documentation#merge#openspec#delta#spec-sync
One-click install
npx skills add https://github.com/crozzbite/DnDApp --skill openspec-sync-specs-crozzbite
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/crozzbite/DnDApp/tree/main/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/crozzbite/DnDApp --skill openspec-sync-specs-crozzbite

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs.

Core Features & Use Cases

  • Intelligent merging: Merge delta specs into main specs with respect for existing content.
  • Delta discovery: Locate delta spec files under openspec/changes/<change>/specs/<capability>/spec.md and apply to the corresponding main spec.
  • Guardrails: Create new main specs for new capabilities and prompt for ambiguity when needed.

Quick Start

Run the openspec sync command to merge delta specs 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 delta specs into main specs using openspec?▼

To merge delta specs into main specs, run the openspec sync command to locate delta files under openspec/changes/<change>/specs/<capability>/spec.md and apply them to openspec/specs/<capability>/spec.md. It intelligently updates existing files or creates new ones.

What happens when merging delta specs creates a new capability?▼

When merging delta specs creates a new capability, the process includes guardrails that automatically create a corresponding main spec file under openspec/specs/<capability>/spec.md instead of failing or overwriting unrelated data.

Does openspec sync archive delta specs after merging them?▼

No, openspec sync applies changes from delta specifications into main specs without archiving them, keeping the original delta spec files intact under the openspec/changes/<change>/ directory.

Can I sync multiple delta specs for different capabilities at once?▼

Yes, the sync process locates delta specs under openspec/changes/<change>/specs/<capability>/spec.md for each capability and updates or creates the corresponding main specs, requiring a delta spec for each capability involved.

Why does the spec merge process prompt for user input?▼

The spec merge process prompts for user input when changes in a delta spec are ambiguous, acting as a guardrail to ensure intelligent merging respects existing content and prevents unintended modifications to main specs.

Related Skills

Explore More Software Engineering Skills→
SiddharthChillaleSiddharthChillale

openspec-sync-specs

Apply ADDED, MODIFIED, REMOVED, and RENAMED delta changes to openspec main spec files.

Community
Advanced
igamenovoerigamenovoer
18

openspec-sync-specs

Merge delta requirement specs into main OpenSpec specification files.

Community
Intermediate
belingudbelingud
30

openspec-archive-change

Archive completed OpenSpec changes with verified artifacts and delta specs.

Community
Advanced
zabinyzabiny
2

openspec-sync-specs

Merge delta specs into main specs and summarize updates.

Official
Advanced