openspec-sync-specs

Apply ADDED, MODIFIED, REMOVED, and RENAMED delta changes to openspec main spec files.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/SiddharthChillale/cloud-operations-reasoning-agent --skill openspec-sync-specs-siddharthchillale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/SiddharthChillale/cloud-operations-reasoning-agent/tree/main/.opencode/skills/openspec-sync-specs
Command: npx skills add https://github.com/SiddharthChillale/cloud-operations-reasoning-agent --skill openspec-sync-specs-siddharthchillale

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual, error-prone work of copying or applying delta specification changes into canonical openspec main specs by reading change deltas and applying targeted updates to requirements and scenarios.

Core Features & Use Cases

  • Selective Intelligent Merges: Read ADDED, MODIFIED, REMOVED, and RENAMED sections from delta spec files and apply only the intended changes to main spec files without overwriting unrelated content.
  • Create or Update Capabilities: Create new capability spec files when absent and append or modify requirements while preserving existing scenarios.
  • Interactive Safeguards: Prompt the user to select the change when ambiguous, show summaries of applied updates, and ensure idempotent operations for safe repeat runs.
  • Use Case: During a release, sync a feature branch's delta specs into the main spec corpus to update requirements and add new test scenarios without losing existing content.

Quick Start

Select the desired change when prompted and instruct the agent to sync that change into the main openspec/specs directory so it applies ADDED, MODIFIED, REMOVED, and RENAMED updates.

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 in openspec?

Use this Skill to read ADDED, MODIFIED, REMOVED, and RENAMED sections from openspec delta specs and apply targeted updates to main spec.md files while preserving existing content.

What is the best way to sync openspec change requirements during a release?

Syncing openspec change requirements during a release is handled by reading change deltas and applying updates to add new test scenarios and modify requirements in the main spec corpus without losing existing content.

Does openspec spec syncing preserve existing scenarios when adding new requirements?

Yes, openspec spec syncing preserves existing scenarios when creating or updating capability spec files, appending or modifying only the intended requirements while keeping unrelated content intact.

Can I create new capability spec files when syncing openspec changes?

Yes, you can create new capability spec files when absent during the sync process, automatically generating the file while appending or modifying requirements from the delta spec updates.

Do I need the openspec CLI to sync delta specs into main specs?

Yes, the openspec CLI is required to sync delta specs, along with read access to openspec change directories and write permission to update or create capability spec.md files.

Are openspec spec sync operations safe to run repeatedly?

Yes, openspec spec sync operations are idempotent for safe repeat runs, providing interactive safeguards that prompt you to select changes when ambiguous and show summaries of applied updates.