skills.rest
jeffbalagosa
jeffbalagosaCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specs from openspec/changes into canonical openspec/specs files.

1|Updated May 22, 2022
Search Tags:#automation#openspec#change-management#delta-specs#spec-merging
One-click install
npx skills add https://github.com/jeffbalagosa/pick-or-shuffle --skill openspec-sync-specs-jeffbalagosa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/jeffbalagosa/pick-or-shuffle/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/jeffbalagosa/pick-or-shuffle --skill openspec-sync-specs-jeffbalagosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs.

Core Features & Use Cases

  • Agent-driven operation: read delta specs under openspec/changes and apply changes to openspec/specs to keep main specs up to date.
  • Intelligent merging: applies ADDED, MODIFIED, REMOVED, and RENAMED changes while preserving content not mentioned in the delta.
  • Safe control flow: prompts for a change name when ambiguous and never auto-selects a change to avoid errors.

Quick Start

Provide the delta change name when prompted and let the agent merge the 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 in OpenSpec?▼

To merge delta specs into main specs in OpenSpec, provide the change name when prompted. The agent reads delta specs from openspec/changes and intelligently applies updates to openspec/specs.

What happens to unrelated content when syncing delta specs?▼

When syncing delta specs, unrelated content not mentioned in the delta is preserved. The intelligent merging only applies ADDED, MODIFIED, REMOVED, and RENAMED changes to the canonical main specs.

How does OpenSpec handle ambiguous delta spec changes?▼

OpenSpec uses a safe control flow that prompts for a change name when ambiguous. It never auto-selects a change to avoid errors during the delta spec merging process.

Do I need to manually select a change to sync OpenSpec delta specs?▼

No, you do not need to manually select a change to sync OpenSpec delta specs. The system will prompt you for the change name to ensure accurate merging without auto-selection.

What is a delta spec in OpenSpec change management?▼

A delta spec in OpenSpec change management represents proposed changes stored under openspec/changes. It includes ADDED, MODIFIED, REMOVED, and RENAMED requirements to update canonical main specs.

Related Skills

Explore More Software Engineering Skills→
open-platform-modelopen-platform-model

openspec-sync-specs

Merge delta specifications into main spec files while preserving unrelated content.

Official
Advanced
SAPSAP
221

openspec-sync-specs

Merge delta specifications into main OpenSpec specs under openspec/specs.

Official
Advanced
yun-s-ohyun-s-oh

openspec-sync-specs

Synchronizes delta specifications into main specifications using the openspec CLI.

Community
Intermediate
carlosapgomescarlosapgomes

openspec-sync-specs

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

Community
Advanced