skills.rest
ybenitezf
ybenitezfCOMMUNITY
Explore all skills by this author →
GitHub

openspec-sync-specs

Merge delta specs from openspec/changes into main specs under openspec/specs.

Updated Apr 6, 2026
Search Tags:#automation#cli#merge#spec#openspec#delta
One-click install
npx skills add https://github.com/ybenitezf/pi-github --skill openspec-sync-specs-ybenitezf
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/ybenitezf/pi-github/tree/main/.opencode/skills/openspec-sync-specs
Command: npx skills add https://github.com/ybenitezf/pi-github --skill openspec-sync-specs-ybenitezf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

Core Features & Use Cases

  • Reads delta specs from openspec/changes and identifies intended modifications.
  • Applies intelligent merges to openspec/specs, preserving existing content not mentioned in the delta.
  • Ensures idempotent updates and prompts for clarification when delta is ambiguous.

Quick Start

Run the delta-spec sync to merge changes from openspec/changes into openspec/specs using the built-in agent.

Frequently Asked Questions about openspec-sync-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync delta specs into main specs without archiving the change?▼

To sync delta specs into main specs, the agent reads changes from openspec/changes and intelligently merges them into openspec/specs, updating main specs while preserving existing content not mentioned in the delta.

What is an intelligent merge for delta specs in OpenSpec?▼

An intelligent merge for delta specs updates main specs by applying changes from openspec/changes while preserving existing content not mentioned in the delta, ensuring idempotent updates and prompting for clarification when ambiguities arise.

How do I update main specs from delta specs using CLI automation?▼

You can update main specs by running the agent-driven delta-spec sync operation, which automatically reads delta specs from openspec/changes and applies intelligent merges to openspec/specs.

Does syncing delta specs overwrite existing content in main specs?▼

No, syncing delta specs does not overwrite existing content. The intelligent merge preserves content in openspec/specs that is not explicitly mentioned in the delta files from openspec/changes.

What happens when a delta spec is ambiguous during the spec sync process?▼

When a delta spec is ambiguous during the sync process, the agent prompts for clarification to resolve the ambiguity before proceeding with the intelligent merge into the main specs.

Related Skills

Explore More Software Engineering Skills→
kunishkunish

openspec-sync-specs

Merge delta specs into main OpenSpec specs with idempotent rules.

Community
Advanced
daodaoedudaodaoedu

openspec-archive-change

Archive completed OpenSpec change directories after validating artifacts and tasks.

Official
Advanced
SAPSAP
221

openspec-sync-specs

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

Official
Advanced
ssd-mkdocs-platformssd-mkdocs-platform
1

openspec-sync-specs

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

Official
Advanced