skills.rest
twilwa
twilwaCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specifications into corresponding main spec files.

Updated Feb 14, 2026
Search Tags:#automation#integration#merge#spec#openspec#delta
One-click install
npx skills add https://github.com/twilwa/THE-REVENGER --skill openspec-sync-specs-twilwa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/twilwa/THE-REVENGER/tree/main/.cursor/skills/openspec-sync-specs
Command: npx skills add https://github.com/twilwa/THE-REVENGER --skill openspec-sync-specs-twilwa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs to apply intelligent merging without archiving the change, ensuring main specs stay up-to-date with delta intent.

Core Features & Use Cases

  • Intelligent merging of delta specifications into corresponding main specs.
  • Creates main spec files when missing and preserves non-delta content.
  • Supports guided prompting to select the delta change before applying updates.

Quick Start

Provide a delta change name or select from available changes to begin syncing delta specs into 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 losing existing content?▼

To merge delta specs safely, the tool synchronizes changes from openspec/changes/<name>/specs into openspec/specs/<capability>/spec.md. It applies intelligent merging rules to preserve non-delta content while updating or creating main spec files.

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

A delta spec represents proposed changes located under openspec/changes. You need to sync it when you want to apply these changes to main specs to keep them up-to-date with the delta intent without archiving the original change folder.

How do I update main spec files if the capability directory does not exist?▼

When the main spec file is missing, the sync process automatically creates the corresponding openspec/specs/<capability>/spec.md file. This ensures the capability structure is established while applying the delta specifications.

Can I select which delta change to apply when syncing specifications?▼

Yes, you can provide a specific delta change name or use guided prompting to select from available changes. This selection happens before the tool applies updates to the main specs.

Are repeated spec sync operations idempotent?▼

Yes, the spec synchronization ensures idempotent updates. Running the merge multiple times on the same delta spec will not duplicate content or alter existing non-delta documentation beyond the initial intelligent merge.

Does merging delta specifications archive the original change folder?▼

No, merging delta specifications applies the intelligent synchronization to main specs without archiving the change. The original delta spec files remain located under openspec/changes/<name>/specs for reference.

Related Skills

Explore More Software Engineering Skills→
PBH-BTNPBH-BTN
6.2k

openspec-sync-specs

Merge delta specifications into main OpenSpec spec files.

Official
Advanced
johnqxujohnqxu

openspec-archive-change

Archive completed OpenSpec changes after verifying artifacts, tasks, and delta specs.

Community
Advanced
agoodwayagoodway

openspec-sync-specs

Merge incremental OpenSpec delta requirements into main capability spec files.

Official
Intermediate
crozzbitecrozzbite

openspec-sync-specs

Merge delta specs into main specs using the openspec CLI.

Community
Advanced