openspec-sync-specs

Merge delta specs into main specs using openspec CLI.

6|Updated Feb 13, 2021
One-click install
npx skills add https://github.com/dezkareid/dezkareid --skill openspec-sync-specs-dezkareid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/dezkareid/dezkareid/tree/main/design-system/design-tokens/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/dezkareid/dezkareid --skill openspec-sync-specs-dezkareid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Delta specs can diverge from the main specs, and this skill provides a controlled, intelligent merge workflow to apply delta changes back into the main specifications without archiving the delta as a separate artifact.

Core Features & Use Cases

  • Reads delta specifications and applies them to main specs with intelligent merging rules.
  • Creates main specs when they do not exist, ensuring alignment across capabilities.
  • Preserves unrelated content and provides prompts to select the correct change when multiple deltas exist.

Quick Start

Run the openspec sync to merge 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 archiving the delta files?

To merge delta specs into main specs without archiving, use the openspec sync workflow. It reads delta files, locates corresponding main specs, and applies changes intelligently while preserving existing unrelated content.

What happens to main specs when a corresponding delta spec cannot be found?

When a matching main spec is absent, the sync operation automatically creates a new main spec from the delta requirements. This ensures alignment across multiple capabilities without leaving specifications missing.

How does openspec handle merging when multiple delta specs exist for the same capability?

When multiple deltas exist for the same capability, openspec prompts the user to select the correct change to apply. This interactive selection ensures the intelligent merging rules apply the intended modifications accurately.

Do I need the openspec CLI installed to sync delta specifications into main specs?

Yes, the openspec CLI is required to sync delta specifications into main specs. The intelligent merging workflow depends on this command-line interface to read deltas, locate main specs, and execute the merge operations.

Will syncing delta specs overwrite unrelated content already present in my main specs?

No, syncing delta specs preserves unrelated content already present in your main specs. The intelligent merging rules target only added or modified requirements, ensuring existing unaltered specifications remain intact during the sync.