skills.rest
MetaCubeX
MetaCubeXOFFICIAL
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specifications into main specs under openspec/specs.

4.1k|508|Updated Jul 11, 2023
Search Tags:#automation#requirements management#openspec#delta specs#merge specs#CI workflow#spec syncing
One-click install
npx skills add https://github.com/MetaCubeX/metacubexd --skill openspec-sync-specs-metacubex
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/MetaCubeX/metacubexd/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/MetaCubeX/metacubexd --skill openspec-sync-specs-metacubex

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specifications often live separately from the main specs, making updates tedious and error-prone. This Skill automates the safe, intelligent merging of delta specs into the corresponding main specs without archiving the delta.

Core Features & Use Cases

  • Intelligent merging of ADDED, MODIFIED, REMOVED, and RENAMED requirements between delta and main specs.
  • Preserves existing content and scenarios not mentioned in the delta.
  • Creates new main spec files when needed and updates multiple capabilities in a batch workflow.

Quick Start

Use the openspec CLI to review and apply delta specs:

  • Run openspec list --json to view available changes.
  • The Skill will locate delta specs under openspec/changes/<change>/specs/<capability>/spec.md and merge them into openspec/specs/<capability>/spec.md, creating the main spec if it doesn't exist.
  • Review the summary output to confirm which capabilities were updated and how.

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?▼

To merge delta specs into main specs without losing content, use the openspec-sync-specs Skill. It intelligently merges ADDED, MODIFIED, REMOVED, and RENAMED changes while preserving existing scenarios and content not mentioned in the delta.

How do I apply delta specification changes to multiple capabilities in a CI workflow?▼

You can apply delta specification changes to multiple capabilities in a batch workflow by running the openspec CLI. The Skill locates delta specs under openspec/changes and updates or creates the corresponding main spec files under openspec/specs for each capability.

What is the best way to automate merging ADDED, MODIFIED, and REMOVED requirements in openspec?▼

The best way to automate merging ADDED, MODIFIED, REMOVED, and RENAMED requirements is using the openspec-sync-specs Skill. It safely applies delta spec changes to main specs automatically, preventing manual update errors.

Does openspec-sync-specs require the openspec CLI to update main spec files?▼

Yes, openspec-sync-specs requires the openspec CLI and appropriate file permissions to read delta specs and modify main specs. You need to run openspec list --json to view available changes before the Skill merges them.

Why are my main spec files not updating when I merge delta specs?▼

Main spec files may not update if the delta specs are not located under openspec/changes/<change>/specs/<capability>/spec.md. Ensure you have the required file permissions to read delta specs and modify the main specs under openspec/specs.

Can I create new main spec files automatically when merging delta specs?▼

Yes, you can create new main spec files automatically when merging delta specs. The Skill creates the main spec file under openspec/specs/<capability>/spec.md if it does not already exist for that capability.

Related Skills

Explore More Software Engineering Skills→
SiddharthChillaleSiddharthChillale

openspec-sync-specs

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

Community
Advanced
tatargabortatargabor
30

openspec-sync-specs

Merge delta specifications into main openspec specs without archiving deltas.

Community
Advanced
emergent-companyemergent-company
1

openspec-sync-specs

Synchronize delta specification files into main specification files using the openspec CLI.

Official
Advanced
wonderslifewonderslife
13

openspec-sync-specs

Merge delta specs into main specs with ADDED, MODIFIED, REMOVED, and RENAMED changes.

Community
Advanced