openspec-sync-specs

Merge delta specs into OpenSpec main specs with idempotent updates.

84|18|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/intent-driven-dev/openspec-schemas --skill openspec-sync-specs-intent-driven-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/intent-driven-dev/openspec-schemas/tree/main/.opencode/skills/openspec-sync-specs
Command: npx skills add https://github.com/intent-driven-dev/openspec-schemas --skill openspec-sync-specs-intent-driven-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs often sit beside main specs; this skill enables safe, intelligent merging of delta changes into the primary OpenSpec specs, preserving existing content and applying delta intent without wholesale replacement.

Core Features & Use Cases

  • Intelligent Delta Merge: merges added/modified/removed delta requirements into main specs while preserving unrelated content.
  • Guarded Operations: reads both delta and main specs before applying changes, asks for user selection when needed, and idempotently applies updates.
  • Broad Scenarios: supports merging changes for multiple capabilities and delta directories under openspec/changes/<name>/specs.

Quick Start

Provide the delta change name and trigger the merge flow to apply delta specs to the corresponding 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 into main specs safely, the skill reads both files first, applies added, modified, removed, and renamed requirements intelligently, and preserves unrelated content during the update.

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

A delta spec captures incremental changes beside main OpenSpec specs. You need to merge it when applying proposed capability changes across multiple spec files to ensure the primary specs reflect the latest updates.

Can I apply delta changes across multiple capabilities at once?

Yes, delta merging supports broad scenarios by applying changes across multiple capabilities and delta directories under openspec/changes/<name>/specs, resolving all modifications in a single idempotent update flow.

How does the merge handle conflicting or modified requirements?

The merge handles modified requirements by prompting for user selection when necessary, reading both delta and main specs beforehand to ensure safe, idempotent updates without wholesale replacement of content.

What's the best way to automate OpenSpec spec updates from delta directories?

The best way to automate spec updates is providing the delta change name to trigger the merge flow, which safely resolves renamed and removed requirements while applying idempotent updates to the main specs.

Are there limitations when merging renamed or removed requirements in OpenSpec?

When merging renamed or removed requirements, the operation requires reading both delta and main specs beforehand and may prompt for user selection to ensure safe updates, preventing wholesale replacement of existing content.