skills.rest
sgiath
sgiathCOMMUNITY
Explore all skills by this author →
Website𝕏@SgiathDevGitHub

openspec-sync-specs

Merge delta specs into main specs with content preservation safeguards.

4|3|Updated Jan 16, 2023
Search Tags:#workflow#validation#merge#spec#openspec#delta
One-click install
npx skills add https://github.com/sgiath/secp256k1 --skill openspec-sync-specs-sgiath
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/sgiath/secp256k1/tree/main/.opencode/skills/openspec-sync-specs
Command: npx skills add https://github.com/sgiath/secp256k1 --skill openspec-sync-specs-sgiath

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs evolve separately and must be integrated into main specs in a safe, auditable way. This skill coordinates intelligent merging to apply delta changes into the main spec without losing context or creating conflicting updates.

Core Features & Use Cases

  • Agent-driven delta merge: read delta specs from openspec/changes/<name>/specs and apply changes to the primary specs.
  • Intelligent merging: preserves existing content not mentioned in the delta and supports idempotent updates.
  • Change-name guided flow: prompts for a change name when missing and validates delta specs before applying.
  • On-demand spec creation: creates main specs if they do not exist yet.

Quick Start

Provide the delta spec change name to initiate merging delta specs into the 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?▼

To merge delta specs, an agent-driven workflow reads delta changes from openspec/changes and applies them to main specs using intelligent merging rules that preserve existing content not mentioned in the delta.

What is the best way to apply delta spec changes to a primary spec set?▼

Applying delta spec changes is best handled by reading both delta and main specs before applying updates, ensuring intelligent merging that supports idempotent updates and prevents conflicting modifications.

Can I create new main specs if they do not exist yet during a delta merge?▼

Yes, you can create new main specs on demand. The merge workflow supports on-demand spec creation for main specs that do not exist yet when applying delta changes.

How do I start merging openspec delta changes if I only have the change name?▼

You can start merging openspec delta changes by providing the change name. The workflow prompts for a change name when missing and validates delta specs before applying them.

Does merging delta specs overwrite content that is not mentioned in the delta changes?▼

No, merging delta specs does not overwrite unmentioned content. Intelligent merging safeguards preserve existing content in the main spec that is not explicitly referenced in the delta.

Related Skills

Explore More Software Engineering Skills→
PBH-BTNPBH-BTN
6.2k

openspec-sync-specs

Merge delta specifications into main OpenSpec spec files.

Official
Advanced
cookeyholdercookeyholder

openspec-sync-specs

Merge delta specifications into main specs with conflict resolution and change summaries.

Community
Advanced
gmf520gmf520
17

openspec-sync-specs

Merge delta OpenSpec requirement changes into main spec files.

Community
Intermediate
carlosapgomescarlosapgomes

openspec-sync-specs

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

Community
Advanced