skills.rest
yuanhsunliu
yuanhsunliuCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

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

Updated Aug 27, 2026
Search Tags:#automation#workflow#documentation#openspec#merging#delta-spec#spec-sync
One-click install
npx skills add https://github.com/yuanhsunliu/dashboard-layout-editor-ui --skill openspec-sync-specs-yuanhsunliu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/yuanhsunliu/dashboard-layout-editor-ui/tree/main/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/yuanhsunliu/dashboard-layout-editor-ui --skill openspec-sync-specs-yuanhsunliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta spec changes often need to be merged into the canonical specs. This Skill automates intelligent merging so delta updates are applied to main specs without archiving or overwriting unrelated content.

Core Features & Use Cases

  • Intelligent delta merging: Merge ADDED, MODIFIED, REMOVED, and RENAMED blocks from delta specs into main specs with content-preserving behavior.
  • Multi-capability updates: Apply changes across multiple openspec capabilities, creating main specs if missing.
  • Guardrails and prompts: If delta details are unclear, prompt for clarification and show a summary of changes before applying.

Quick Start

Run the delta-spec synchronization to merge delta changes into the main specs and update them accordingly.

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 overwriting existing content?▼

Delta spec synchronization merges ADDED, MODIFIED, REMOVED, and RENAMED blocks from delta specifications into main specs while preserving unrelated content. It updates or creates main specs across capabilities without archiving the original delta files.

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

A delta spec represents incremental changes stored under openspec/changes/<name>/specs. You need to sync delta specs when those changes must be applied to the canonical main specs, ensuring updates are merged intelligently without losing existing details.

Can I update multiple openspec capabilities at once when merging delta specifications?▼

Yes, delta spec synchronization supports multi-capability updates. It reads delta specs and applies changes across multiple openspec capabilities, automatically creating main specs if they are missing during the merging process.

How do I handle ambiguous delta spec details during the merging process?▼

When delta details are ambiguous, the synchronization process pauses and prompts you for clarification. It also displays a summary of proposed changes before applying them, ensuring the merged main specs accurately reflect your intent.

Does delta spec synchronization support renaming and removing content blocks?▼

Yes, delta spec synchronization processes ADDED, MODIFIED, REMOVED, and RENAMED rules. It intelligently applies these operations to update main specs, ensuring removed content is deleted and renamed content is correctly relocated.

What's the best way to automate openspec workflow documentation updates?▼

Automating openspec documentation updates involves running delta spec synchronization to merge changes from openspec/changes into main specs. This applies delta rules across capabilities and creates missing specs, keeping canonical documentation current.

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
SAPSAP
221

openspec-sync-specs

Merge delta specifications into main OpenSpec specs under openspec/specs.

Official
Advanced
AdJIaAdJIa

openspec-sync-specs

Merge delta spec changes into main OpenSpec specs idempotently.

Community
Advanced
wzyxdwllwzyxdwll
14

openspec-sync-specs

Merge delta specs into main specs while preserving unrelated content.

Community
Intermediate