openspec-sync-specs

Merge delta specifications into main specs from openspec/changes.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/ishibata91/ai-translation-engine-2 --skill openspec-sync-specs-ishibata91
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/ishibata91/ai-translation-engine-2/tree/main/.agent/skills/openspec-sync-specs
Command: npx skills add https://github.com/ishibata91/ai-translation-engine-2 --skill openspec-sync-specs-ishibata91

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. This operation merges delta specs into main specs to apply the changes without archiving the delta, enabling intelligent merging (e.g., adding a scenario without duplicating the entire requirement).

Core Features & Use Cases

  • Reads delta specifications from openspec/changes and applies them to corresponding main specs.
  • Handles ADDED, MODIFIED, REMOVED, and RENAMED requirements with intelligent merging while preserving unrelated content.
  • Provides guidance for workspace setup, delta selection, and idempotent execution to ensure safe repeat runs.

Quick Start

Move to the workspace and run the delta-spec syncing workflow to apply delta changes to 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 into main specs applies added, modified, removed, or renamed requirements while preserving unrelated content. This intelligent merging process updates specifications without duplicating existing requirements.

What is an openspec delta specification and when do I need to sync it?

An openspec delta specification contains pending changes stored in openspec/changes. You need to sync it when applying those tracked modifications to your main specifications to update the project requirements.

How do I apply openspec changes to update main specifications?

To apply openspec changes, run the delta-spec syncing workflow in your workspace. It reads delta specs from openspec/changes and merges them into corresponding main specs, prompting for selection when multiple delta changes exist.

Do I need the openspec CLI installed to sync delta specifications?

Yes, syncing delta specifications requires the openspec CLI context in your workspace. The workflow validates the environment to ensure the necessary CLI setup is present before merging changes.

Is it safe to run delta spec syncing multiple times on the same workspace?

Yes, delta spec syncing validates changes for idempotence, ensuring safe repeat runs. Running the workflow multiple times applies the same delta changes without causing duplication or corruption.

What's the best way to handle renamed or removed requirements during spec merges?

The best way to handle renamed or removed requirements is using intelligent delta merging, which processes these specific change types to update main specs accurately while preserving unrelated requirements.