openspec-sync-specs

Merge delta specification changes into main openspec spec files.

Updated Dec 11, 2025
One-click install
npx skills add https://github.com/dorrio/sorteo-app-generator --skill openspec-sync-specs-dorrio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/dorrio/sorteo-app-generator/tree/main/.agent/skills/openspec-sync-specs
Command: npx skills add https://github.com/dorrio/sorteo-app-generator --skill openspec-sync-specs-dorrio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of updating main specification files with changes defined in delta specification files, ensuring consistency without manual merging.

Core Features & Use Cases

  • Intelligent Merging: Applies additions, modifications, removals, and renames of requirements to main specs.
  • Contextual Selection: Prompts the user to select a change if not explicitly provided.
  • Use Case: After implementing a new feature based on a delta spec, use this Skill to seamlessly integrate those changes into the main documentation.

Quick Start

Use the openspec-sync-specs skill to sync the changes from the 'feature-x' branch into the main specifications.

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 to main specs in openspec?

To sync delta specs, this Skill intelligently merges requirement additions, modifications, removals, and renames from your specified change files directly into the main specification files.

What are delta specs and when do I need to merge them?

Delta specs define requirement changes for a specific feature in `openspec/changes/<name>/specs/`. You merge them into main specs after implementing a feature to ensure documentation consistency without manual file merging.

How do I update main specification files with new feature requirements?

You update main specification files by applying changes from delta specification files. The Skill prompts you to select a specific change if one is not explicitly provided, then updates `openspec/specs/<capability>/spec.md`.

Do I need the openspec CLI to synchronize specification files?

Yes, you need the openspec CLI installed to synchronize specification files. The Skill requires the CLI to list available changes and apply the updates to your main specification files.

Can I automatically rename or remove requirements when syncing openspec changes?

Yes, when syncing openspec changes, the Skill supports intelligent merging that automatically handles requirement additions, modifications, removals, and renames across your specification files.