openspec-sync-specs

Merge OpenSpec delta changes into main specs while preserving existing content.

2|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/tim-hub/powerball --skill openspec-sync-specs-tim-hub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/tim-hub/powerball/tree/main/openspec-rewrite/skills/openspec-sync-specs
Command: npx skills add https://github.com/tim-hub/powerball --skill openspec-sync-specs-tim-hub

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Merge OpenSpec delta changes into main specs with intelligent, agent-driven updates.

Core Features & Use Cases

  • Agent-driven delta merge: reads delta specs and updates main specs with intelligent merging while preserving unrelated content.
  • Guarded operations: supports ADDED, MODIFIED, REMOVED, and RENAMED changes with safeguards to prevent unintended overwrites.
  • Use Case: when a delta introduces new requirements or modifies existing ones, apply changes to main specs without discarding existing content.

Quick Start

Provide the delta change name to apply and let the agent merge OpenSpec specs into 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 OpenSpec delta changes into main specs without losing existing content?

To merge OpenSpec delta changes, provide the delta change name to an agent-driven process that applies updates while preserving unrelated content. It intelligently merges modifications across capabilities and prompts for input when context is unclear.

What is an OpenSpec delta merge and how does it handle spec modifications?

An OpenSpec delta merge integrates incremental spec updates into main specs using an agent-driven process. It supports ADDED, MODIFIED, REMOVED, and RENAMED changes with safeguards to prevent unintended overwrites of existing content.

Can I apply OpenSpec spec changes if the target capability does not exist yet?

Yes, when applying OpenSpec spec changes, the merge process automatically creates missing specs if needed. This ensures new capabilities introduced by the delta are properly generated and documented during the update.

What's the best way to apply OpenSpec delta changes safely without overwriting unrelated specs?

The best way to apply OpenSpec delta changes safely is using guarded operations. The agent-driven merge supports safeguards that prevent unintended overwrites, preserving existing content while applying targeted modifications across capabilities.

Why does the OpenSpec merge process prompt me for input during a delta update?

The OpenSpec merge process prompts for input when context is unclear during the delta update. This intelligent, agent-driven approach ensures ambiguous changes are clarified before merging, preventing incorrect modifications to main specs.

Do I need to manually validate OpenSpec specs after merging delta changes?

Manual validation is reduced because the merge process returns a summary of updated capabilities and changes. This automated summary provides the necessary validation feedback by detailing exactly what was modified, added, or removed.