openspec-sync-specs

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

Updated Feb 4, 2026
One-click install
npx skills add https://github.com/SQDR2/PortableConversationScriptAssistant --skill openspec-sync-specs-sqdr2
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/SQDR2/PortableConversationScriptAssistant/tree/main/.github/skills/openspec-sync-specs
Command: npx skills add https://github.com/SQDR2/PortableConversationScriptAssistant --skill openspec-sync-specs-sqdr2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates merging delta specifications into the canonical main specs, enabling safe, incremental updates without wholesale replacements.

Core Features & Use Cases

  • Intelligent delta-merging: apply ADDED, MODIFIED, REMOVED, and RENAMED changes to main specs with preserved content.
  • Interactive guidance: prompts for selecting a delta change when the target is ambiguous.
  • Idempotent updates: re-running yields the same outcome.

Quick Start

Tell me the delta change name to apply, and I will merge the corresponding delta 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 specifications into main specs without overwriting existing content?

Merging delta specifications into main specs preserves untouched content by reading both files and intelligently applying ADDED, MODIFIED, REMOVED, and RENAMED blocks to update or create the corresponding main spec files.

What is the best way to apply incremental spec changes in openspec?

Applying incremental spec changes in openspec is done by processing per-capability delta specs located under openspec/changes/<name>/specs, which automatically updates canonical main specs while preserving existing content.

Can I re-run a delta spec merge without duplicating changes?

Re-running a delta spec merge is fully idempotent, meaning applying the same delta changes multiple times yields the exact same outcome without duplicating modifications or creating conflicting content.

How does delta merging handle ambiguous spec changes?

Delta merging handles ambiguous spec changes by providing interactive guidance, prompting you to select the correct delta change when the target main spec file is unclear or multiple matches exist.

Does openspec delta merging support REMOVED and RENAMED spec blocks?

Openspec delta merging supports REMOVED and RENAMED spec blocks, intelligently processing these changes alongside ADDED and MODIFIED blocks to accurately update the main specification files.

When do I need to sync delta specs into main specs?

You need to sync delta specs into main specs when you want to apply incremental updates to canonical specifications safely, avoiding wholesale replacements while maintaining consistency across your project's spec files.