skills.rest
mrclrchtr
mrclrchtrCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

openspec-sync-specs

Merge delta OpenSpec specification changes into main spec directories.

54|3|Updated Apr 13, 2026
Search Tags:#cli#merge#idempotent#openspec#delta-specs#spec-management#spec-sync
One-click install
npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-sync-specs-mrclrchtr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/mrclrchtr/SuPi/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/mrclrchtr/SuPi --skill openspec-sync-specs-mrclrchtr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual, error-prone work of copying and reconciling delta specification changes into the main OpenSpec repository by reading delta spec markdown and applying targeted updates to main spec files while preserving unrelated content.

Core Features & Use Cases

  • Intelligent merging: Apply ADDED, MODIFIED, REMOVED, and RENAMED sections from delta specs into existing capability spec files without wholesale replacement.
  • Create missing capabilities: Automatically create a new main spec file for capabilities that do not yet exist and populate it with added requirements.
  • Safe, agent-driven workflow: Prompts the user to select the change, summarizes edits, preserves untouched scenarios, and ensures idempotent operations for repeated runs.

Quick Start

Select the change with delta specs when prompted and apply the sync to update the main openspec/specs accordingly.

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 specs into main spec files?▼

To merge OpenSpec delta specs, you sync changes by reading ADDED, MODIFIED, REMOVED, and RENAMED sections from delta markdown and applying targeted updates to main spec files while preserving unaffected content.

What is delta spec synchronization in OpenSpec?▼

Delta spec synchronization is the process of reconciling changes from openspec/changes directories into openspec/specs, adding, modifying, or removing requirements across capabilities without wholesale file replacement.

Do I need the openspec CLI to sync delta specs?▼

Yes, you need the openspec CLI installed to sync delta specs, as the workflow relies on its environment to read delta markdown files and apply summarized updates to the main specification directories.

How does spec sync handle capabilities that do not exist yet?▼

Spec sync automatically creates missing main spec files for new capabilities and populates them with the added requirements defined in the delta spec markdown sections.

Is running delta spec synchronization idempotent for repeated runs?▼

Yes, delta spec synchronization is idempotent, ensuring that repeated sync runs produce consistent main spec files without duplicating applied changes or corrupting preserved content.

What happens to untouched scenarios when syncing modified requirements?▼

When syncing modified requirements, untouched scenarios and unrelated content in the main spec files are safely preserved, prompting the user only for ambiguous choices during the merge.

Related Skills

Explore More Software Engineering Skills→
jankneumannjankneumann
4

openspec-sync-specs

Merge delta spec changes into main OpenSpec specification files.

Community
Intermediate
cynkracynkra
1

openspec-sync-specs

Merge delta OpenSpec requirement blocks into main spec files per capability.

Official
Intermediate
psaccpsacc

openspec-sync-specs

Merge delta specification changes into main openspec spec files.

Community
Advanced
ywh0606ywh0606

opsx-sync

Sync delta specification changes into the main specification repository.

Community
Intermediate