openspec-sync-specs

Merges delta specs from openspec/changes into main specs at openspec/specs.

9|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/fjpulidop/specrails-core --skill openspec-sync-specs-fjpulidop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/fjpulidop/specrails-core/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/fjpulidop/specrails-core --skill openspec-sync-specs-fjpulidop

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. This capability enables intelligent merging of incremental spec changes without archiving or overwriting the main specification.

Core Features & Use Cases

  • Intelligent delta merging: Applies ADDED, MODIFIED, REMOVED, and RENAMED changes to the main specs while preserving existing content not mentioned in the delta.
  • Ambiguity handling: Prompts for a change when multiple delta specs are available, avoiding guesswork.
  • Delta scoping: Reads delta specs from openspec/changes and updates or creates main specs at openspec/specs as needed.

Quick Start

Run the delta-sync command with the desired change name to apply delta specs to the 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 overwriting existing requirements?

Intelligent delta merging applies ADDED, MODIFIED, REMOVED, and RENAMED changes from delta specs to main specs while preserving existing content not mentioned in the delta. This avoids overwriting the main specification during the sync process.

What happens when multiple delta specs are available for a change?

When multiple delta specs are available for a change, the sync process prompts the user to select the correct change. This ambiguity handling avoids guesswork and ensures the correct delta spec is applied to the main specs.

How to sync openspec change requirements to a new main spec file?

To sync openspec change requirements to a new main spec, run the delta-sync command with the desired change name. The tool reads delta specs from openspec/changes and automatically creates new main specs at openspec/specs if they are currently missing.

Does delta spec merging handle removed and renamed requirements?

Yes, delta spec merging handles removed and renamed requirements. The intelligent merge applies ADDED, MODIFIED, REMOVED, and RENAMED changes to the main specs and reports a summary of all performed changes after the sync completes.

What is the best way to apply incremental spec changes in openspec?

The best way to apply incremental spec changes in openspec is to use a delta-sync command. It reads both delta and main specs before making changes, merges the requirements intelligently, and generates a summary of the performed modifications.