openspec-sync-specs

Merge delta specs from openspec/changes into main OpenSpec specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to synchronize delta specifications back into the main OpenSpec specs, ensuring changes are applied consistently without archiving the delta.

Core Features & Use Cases

  • Delta-driven merging: Apply delta specs to main specs while preserving unrelated content.
  • Intelligent conflict handling: Merge or update requirements (ADDED, MODIFIED, REMOVED, RENAMED) with minimal disruption.
  • Automation-friendly: Works with the OpenSpec CLI to enumerate changes and apply updates in batch.

Quick Start

Open the delta spec changes under openspec/changes and run the openspec-sync-specs tool to apply them to the main specs. If multiple changes exist, select one with the OpenSpec CLI as described in the delta instructions.

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 without losing existing content, apply delta specifications stored under openspec/changes. The process preserves all unrelated content while intelligently applying ADDED, MODIFIED, REMOVED, and RENAMED requirements to the main specifications.

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

A delta spec sync applies incremental specification changes back into main OpenSpec documents. You need it when changes accumulate under openspec/changes and must be consolidated into the main specs without archiving the original delta files.

How to apply ADDED, MODIFIED, and REMOVED requirements to openspec specifications?

To apply ADDED, MODIFIED, and REMOVED requirements to openspec specifications, run the openspec-sync-specs tool. It uses intelligent merging rules to update or create main specs based on the delta changes, ensuring minimal disruption to the overall document.

Can I batch merge multiple delta spec changes using the openspec CLI?

Yes, you can batch merge multiple delta spec changes using the openspec CLI. The CLI enumerates the available changes under openspec/changes, allowing you to select and apply multiple updates to the main specs in an automation-friendly workflow.

Does merging delta specs with openspec archive the original change files?

Merging delta specs with openspec does not archive the original delta files. The tool synchronizes the changes into the main specifications while leaving the delta specs intact under the openspec/changes directory for future reference or auditing.

What happens to unrelated content when syncing delta specs into main specs?

Unrelated content remains fully preserved when syncing delta specs into main specs. The intelligent merging mechanism only targets sections mentioned in the delta, ensuring that existing requirements outside the delta scope are not modified or removed.