openspec-sync-specs

Merge delta specs from openspec/changes into openspec/specs while preserving existing content.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/soyrochus/vulgata --skill openspec-sync-specs-soyrochus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/soyrochus/vulgata/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/soyrochus/vulgata --skill openspec-sync-specs-soyrochus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The OpenSpec delta-sync tool helps teams merge delta specs into main specs while preserving existing content and avoiding destructive changes.

Core Features & Use Cases

  • Intelligent delta merging: reads delta specs from openspec/changes and updates or creates main specs under openspec/specs, preserving non-delta content.
  • Change summarization: provides a concise summary of updates and maintains idempotency so repeated runs do not duplicate work.
  • Safe collaboration: supports agent-driven workflows by guiding the user to select appropriate deltas and applying changes with guardrails.

Quick Start

Run the openspec-sync-specs tool to merge delta specs into 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 losing existing content?

To merge delta specs without losing existing content, apply delta changes from openspec/changes to openspec/specs using intelligent merging rules that preserve unspecified content and safely update or create main specs.

What is a delta spec in OpenSpec spec management?

A delta spec in OpenSpec spec management represents incremental changes stored in openspec/changes that need to be merged into main specs under openspec/specs while preserving existing content.

Can I safely re-run spec merging if the process is interrupted?

Yes, you can safely re-run spec merging because the process is idempotent, meaning repeated runs do not duplicate work and maintain state consistency without causing destructive changes to existing content.

Does the OpenSpec merge tool support automated agent workflows?

Yes, the OpenSpec merge tool supports automated agent workflows by guiding users to select appropriate deltas and applying changes with guardrails to ensure safe collaboration during spec management.

Why does my delta spec merge overwrite existing main spec content?

A delta spec merge should not overwrite existing main spec content if using intelligent merging rules that preserve unspecified content, ensuring only targeted delta changes are applied safely.

What is the best way to automate OpenSpec documentation updates?

The best way to automate OpenSpec documentation updates is to merge delta specs into main specs, creating a concise summary of updates while maintaining idempotency for safe, non-destructive collaboration.