openspec-sync-specs

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

1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/durandom/layton --skill openspec-sync-specs-durandom
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/durandom/layton/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/durandom/layton --skill openspec-sync-specs-durandom

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs often accumulate behind the scenes and the main specs lag behind. This tool merges delta specs into main specs intelligently, reducing drift and manual edits.

Core Features & Use Cases

  • Intelligent merging across ADDED, MODIFIED, REMOVED, and RENAMED requirements.
  • Prompts for a change name when multiple delta options exist and updates main specs accordingly.
  • Preserves existing content not mentioned in the delta, and outputs a summary of changes for auditing.

Quick Start

Run the openspec-sync-specs tool and follow prompts to merge a delta spec into its main spec.

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?

Run the openspec-sync-specs tool to apply ADDED, MODIFIED, REMOVED, and RENAMED changes to the corresponding main specs. The tool prompts for a change name when multiple delta options exist, preserving existing content not mentioned in the delta.

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

A delta spec captures incremental requirement changes that accumulate while main specs lag behind. You need to sync delta specs to reduce drift and eliminate manual edits when your specifications fall out of alignment with recent requirement changes.

Can I rename or remove requirements when merging specifications?

Yes, specification merging supports both RENAMED and REMOVED change types alongside ADDED and MODIFIED. The tool intelligently applies all four change types to the corresponding main specs during the synchronization process.

How does spec merge handle multiple delta options at once?

When multiple delta options exist, the merge tool prompts you to select a specific change name before updating the main specs. This interactive selection ensures the correct delta is applied to the corresponding main specification.

Are merged specification updates idempotent and auditable?

Yes, merged specification updates are idempotent, meaning repeated merges produce the same result without duplication. The tool also outputs a summary of all applied changes for auditing purposes after synchronization completes.