skills.rest
thelegendtubaguy
thelegendtubaguyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-sync-specs

Merge delta specs into main specs by applying ADDED, MODIFIED, REMOVED, and RENAMED changes.

33|5|Updated Feb 24, 2026
Search Tags:#automation#workflow#consistency#merge#openspec#delta#specs
One-click install
npx skills add https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized --skill openspec-sync-specs-thelegendtubaguy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized/tree/main/.pi/skills/openspec-sync-specs
Command: npx skills add https://github.com/thelegendtubaguy/Qidi-Max-4-Optimized --skill openspec-sync-specs-thelegendtubaguy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

Core Features & Use Cases

  • Delta-driven merge: read delta specs and apply ADDED, MODIFIED, REMOVED, and RENAMED requirements to main specs.
  • Guided, agent-driven workflow: resolve change context, identify delta specs, and perform guarded edits with idempotent results.
  • Auto-create and preserve: create a new main spec when missing and preserve content not mentioned in the delta.

Quick Start

Run openspec sync to merge a delta spec 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 without archiving the change?▼

Run openspec sync to apply ADDED, MODIFIED, REMOVED, and RENAMED changes from delta specs into main specs. This guided workflow performs guarded edits to preserve untouched content and avoid wholesale replacement.

What is a delta spec and when do I need to sync it?▼

A delta spec contains ADDED, MODIFIED, REMOVED, and RENAMED changes. You need to sync it when updating central specs with these changes without replacing the entire main spec or archiving the change record.

Does openspec sync preserve existing content when applying delta requirements?▼

Yes, openspec sync preserves content not mentioned in the delta. It applies only the specified changes, keeping untouched sections of the main spec intact during the guarded merge process.

Can I create a new main spec if the capability does not exist yet?▼

Yes, when a capability does not exist, openspec sync creates a new main spec automatically. It applies the delta changes to establish the initial spec without requiring a pre-existing main spec file.

What is the best way to automate spec consistency across workflow changes?▼

Using an agent-driven workflow with openspec sync automates spec consistency. It resolves change context and applies idempotent, guarded edits from delta specs to main specs, ensuring structured updates across merges.

Why does my delta spec merge result in wholesale replacement instead of a guarded edit?▼

Wholesale replacement happens if the structured delta format is not followed. Using openspec sync enforces the ADDED, MODIFIED, REMOVED, and RENAMED format to ensure guarded edits and preserve untouched content.

Related Skills

Explore More Software Engineering Skills→
wonderslifewonderslife
13

openspec-sync-specs

Merge delta specs into main specs with ADDED, MODIFIED, REMOVED, and RENAMED changes.

Community
Advanced
artagonartagon

openspec-sync-specs

Merge delta OpenSpec requirement changes into main capability specs.

Official
Intermediate
inspedralbesinspedralbes

openspec-sync-specs

Merge delta specs into main specs with guided change selection.

Official
Advanced
joannanowakowskajoannanowakowska

openspec-sync-specs

Merge delta specifications into canonical OpenSpec files with requirement-level updates.

Community
Advanced