openspec-sync-specs

Merge delta specifications from an active OpenSpec change into main specifications.

4|9|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/DataDave-Dev/weftmap --skill openspec-sync-specs-datadave-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/DataDave-Dev/weftmap/tree/main/.codex/skills/openspec-sync-specs
Command: npx skills add https://github.com/DataDave-Dev/weftmap --skill openspec-sync-specs-datadave-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps keep main OpenSpec specifications aligned with approved delta specs without archiving the active change, avoiding manual copying and preserving existing requirements.

Core Features & Use Cases

  • Intelligent Spec Merging: Applies added, modified, removed, and renamed requirements while preserving unaffected content.
  • Change Discovery: Resolves the appropriate OpenSpec change and reads its delta specifications before editing main specs.
  • Validation and Summaries: Supports store-aware OpenSpec workflows and reports which capabilities and requirements were updated.
  • Use Case: When a feature change is complete but should remain active, use this Skill to merge its delta requirements into the corresponding main specifications without archiving the change.

Quick Start

Ask the Skill to sync the delta specifications from the selected OpenSpec change into the main specifications and summarize the updates.

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 OpenSpec delta specifications into main specs without archiving the change?

To merge delta specifications, use this Skill to synchronize change specs into your main OpenSpec specifications. It applies additions, modifications, removals, and renames while keeping the active change unarchived and preserving unaffected requirements.

What is specification sync in OpenSpec and when do I need it?

Specification sync in OpenSpec is the process of aligning approved delta specs with main specifications. You need it when a feature change is complete but should remain active, allowing you to update requirements without manual copying or archiving.

Does merging change specs into main specifications preserve existing requirements?

Yes, merging change specs intelligently preserves unmentioned requirements. The synchronization process applies only the added, modified, removed, and renamed elements from the active delta spec, leaving all other existing content in your main specifications intact.

Do I need the OpenSpec CLI to synchronize software documentation specs?

Yes, the OpenSpec CLI is required to synchronize software documentation specs. This Skill relies on the CLI environment to resolve the appropriate OpenSpec change, read its delta specifications, and apply store-aware workflow updates to main specs.

How do I get a summary of updated capabilities after syncing OpenSpec requirements?

To get a summary of updated capabilities, ask the Skill to sync delta specifications from your selected OpenSpec change into the main specifications. It validates the store-aware workflow and reports which capabilities and requirements were updated.

What happens to unarchived OpenSpec changes after a specification merge?

After a specification merge, the unarchived OpenSpec change remains active. The Skill synchronizes the delta requirements into the corresponding main specifications without archiving, allowing the change to stay available for further modifications.