openspec-sync-specs

Merge delta spec rules into main OpenSpec spec files.

2|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/dshearer/misatay --skill openspec-sync-specs-dshearer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/dshearer/misatay/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/dshearer/misatay --skill openspec-sync-specs-dshearer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs.

Core Features & Use Cases

  • Multistep delta-merge of specs
  • Intelligent merging of ADDED, MODIFIED, REMOVED, and RENAMED rules
  • Safe, idempotent updates with prompts when needed

Quick Start

Provide a delta spec name to apply to your main specs and review the results.

Frequently Asked Questions about openspec-sync-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is delta spec merging in OpenSpec and when do I need it?

Delta spec merging applies proposed specification changes from openspec/changes to your main specs under openspec/specs. You need it when finalizing development workflow changes to update ADDED, MODIFIED, REMOVED, or RENAMED rules intelligently.

How do I sync delta specs to main specs in my development workflow?

To sync delta specs, provide the delta spec name to apply to your main specs. The tool reads both delta and main spec files, merges the rules, prompts for disambiguation if necessary, and updates the main spec.md files safely.

Can I run delta spec merging multiple times without corrupting my main specs?

Yes, syncing delta specs is an idempotent operation. Running the merge process multiple times on the same delta spec yields the same result without duplicating rules or corrupting your main specification files.

Does OpenSpec spec merging support REMOVED and RENAMED rules automatically?

Yes, the delta merge process supports ADDED, MODIFIED, REMOVED, and RENAMED rules. It intelligently merges these changes into main specs and prompts you when necessary for disambiguation during the update.

What happens when the spec sync tool encounters conflicting modifications?

When the spec sync tool encounters ambiguous changes during merging, it pauses and prompts you for disambiguation. This ensures safe updates and prevents unintended modifications to your main specification files.