openspec-sync-specs

Merge delta specs into main specs under openspec/specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

Core Features & Use Cases

  • Agent-driven delta-merge: read delta specs and apply changes to the corresponding main specs with intelligent, partial updates.
  • Guardrails and prompts: if multiple deltas are available, prompt the user to select the delta change; preserves content not mentioned in the delta.
  • Idempotent updates: running the operation again yields the same result and does not duplicate changes.

Quick Start

Run the delta-sync workflow by specifying the delta change name to begin merging into 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 in openspec?

To merge delta specs into main specs in openspec, the delta-sync workflow reads changes under openspec/changes/<name>/specs and applies them to openspec/specs. It handles added, modified, removed, and renamed requirements with intelligent merging while preserving unmentioned content.

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

A delta spec represents proposed changes located under openspec/changes. You need to sync a delta spec when you want to update main specifications with these changes without archiving the original delta change folder.

Can I apply delta changes to main specs without archiving the delta?

Yes, you can apply delta changes without archiving the delta. The sync workflow merges specified delta changes directly into main specs idempotently, ensuring running it again yields the same result without duplicating changes or removing the delta.

How do I handle multiple delta changes when syncing specs?

When multiple delta changes are available, the sync workflow provides guardrails and prompts you to select the specific delta change name. This ensures you explicitly choose which changes to merge into the main specs.

Does the spec sync create a main spec if one is missing?

Yes, the spec sync creates a main spec if the corresponding specification is missing. It reads both delta and main specs, applies changes idempotently, and outputs a summary of all updates including newly created files.