openspec-sync-specs

Merge delta specification changes into main specifications using the openspec CLI.

1|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/harqian/wifi-client --skill openspec-sync-specs-harqian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/harqian/wifi-client/tree/main/.gemini/skills/openspec-sync-specs
Command: npx skills add https://github.com/harqian/wifi-client --skill openspec-sync-specs-harqian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openspec, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the need for updating main specifications with changes from delta specs, ensuring that the latest changes are applied without overwriting existing content.

Core Features & Use Cases

  • Delta Spec Synchronization: Merges changes from delta specs into main specs, maintaining the integrity of existing data.
  • Agent-Driven Operation: Prompts the user to select the change name and applies changes accordingly, ensuring user control over the process.
  • Intelligent Merging: Applies changes like adding, modifying, removing, or renaming requirements intelligently without duplicating content.
  • Use Case: When you need to incorporate changes from a delta spec into the main specifications without losing any existing information.

Quick Start

Run the 'openspec-sync-specs' skill and provide the change name or let it infer from context. The skill will apply the delta spec changes to 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 specifications into main specs without overwriting existing content?

To merge delta specifications without overwriting existing content, use an intelligent synchronization process that applies additions, modifications, and removals while preserving original data. This ensures accurate updates across multiple capabilities without duplicating requirements.

What is the best way to synchronize requirement changes across multiple software capabilities?

Synchronizing requirement changes across multiple capabilities requires automating the delta spec merging process. This approach intelligently applies changes like adding, modifying, or renaming requirements to maintain specification integrity during software updates.

Do I need the openspec CLI to automate specification synchronization?

Yes, you need the openspec CLI installed to automate specification synchronization. The merging operation depends on this command-line tool to execute delta spec updates and apply changes to the main specifications accurately.

Can I select specific requirement changes to apply when updating software specifications?

Yes, you can select specific requirement changes during software specification updates. The synchronization operation prompts you to choose the specific change name, ensuring you maintain direct control over which delta modifications are applied to the main specs.

How does intelligent delta spec merging handle renaming or removing requirements?

Intelligent delta spec merging handles renaming or removing requirements by applying these specific changes to the main specifications without duplicating content. It ensures existing data integrity is preserved while accurately reflecting the latest requirement modifications.

When do I need to synchronize delta specs for software updates?

You need to synchronize delta specs for software updates when you have pending requirement changes that must be incorporated into main specifications. This process ensures the latest modifications are accurately applied without losing any existing specification information.