openspec-sync-specs

Merge delta spec changes into main specification sets.

Updated Nov 26, 2025
One-click install
npx skills add https://github.com/hmj1026/docker_run --skill openspec-sync-specs-hmj1026
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/hmj1026/docker_run/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/hmj1026/docker_run --skill openspec-sync-specs-hmj1026

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs can diverge from main specs; this skill provides an agent-driven workflow to merge delta changes back into main specs.

Core Features & Use Cases

  • Intelligent merging: applies ADDED/MODIFIED/REMOVED changes from delta specs to main specs while preserving existing content.
  • Interactive delta discovery: prompts user to select a change when multiple delta specs exist.
  • Audit-ready summaries: outputs a concise sync summary to review before archiving.

Quick Start

Use openspec-sync-specs to synchronize delta changes 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?

Merging delta specs involves applying adds, mods, and removes from the delta specification into the main specs. This process intelligently applies changes while preserving existing content.

What is the workflow for synchronizing delta specs to a main specification set?

Synchronizing delta specs uses an agent-driven workflow that reads both delta and main specification files, prompts the user for change selection when ambiguous, and generates a Specs Synced summary for review.

How do I handle multiple delta specs when synchronizing changes?

When multiple delta specs exist during synchronization, the workflow provides interactive delta discovery. It prompts you to select the specific change you want to apply to the main specification set.

Can I review changes before archiving synced specifications?

Yes, you can review changes before archiving synced specifications. The workflow outputs an audit-ready Specs Synced summary that concisely documents all applied changes for your review.

When do I need to use delta specs for specification management?

You need delta specs when your working changes diverge from main specs and must be merged back. They provide a structured format to define ADDED, MODIFIED, and REMOVED changes for synchronization.