openspec-sync-specs

Merge delta specification changes into main project documentation.

6|Updated May 25, 2026
One-click install
npx skills add https://github.com/zhentingWu-wzt/wgenty-code --skill openspec-sync-specs-zhentingwu-wzt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/zhentingWu-wzt/wgenty-code/tree/main/.wgenty-code/skills/openspec-sync-specs
Command: npx skills add https://github.com/zhentingWu-wzt/wgenty-code --skill openspec-sync-specs-zhentingwu-wzt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resolves the friction of keeping main project specifications updated when working with delta changes, preventing manual copy-paste errors and ensuring requirement consistency.

Core Features & Use Cases

  • Intelligent Merging: Automatically applies additions, modifications, removals, and renames from delta specs into main specification files.
  • Context-Aware Updates: Uses the openspec CLI to verify change status and workspace planning modes before applying mutations.
  • Use Case: When a developer completes a feature branch with specific delta requirements, use this tool to merge those changes into the master documentation without overwriting existing, unrelated scenarios.

Quick Start

Use the openspec-sync-specs skill to synchronize the delta changes from the current active change into the main project 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 merge delta specification changes into main project documentation?

Merging delta specification changes into main project documentation involves parsing structured Markdown delta files to apply additions, modifications, removals, and renames intelligently. This prevents manual copy-paste errors and ensures requirement consistency across feature branches.

Do I need the openspec CLI to sync delta specs?

Yes, the openspec CLI is required to sync delta specs. The synchronization process depends on the CLI to verify change status, resolve change contexts, determine file paths, and check workspace planning modes before applying mutations to main specification files.

What is intelligent merging for requirements and scenarios?

Intelligent merging for requirements and scenarios is the automated process of applying delta specification changes into master documentation. It contextually updates capability definitions without overwriting existing, unrelated scenarios, ensuring only the targeted delta modifications are synchronized.

How do I update master specifications from a feature branch without overwriting unrelated scenarios?

To update master specifications from a feature branch without overwriting unrelated scenarios, use an automated synchronization tool that parses structured Markdown delta files. It applies only the targeted additions, modifications, and removals while preserving the existing unrelated content.

When should I not use automated delta spec synchronization?

Automated delta spec synchronization should not be used when the openspec CLI is not installed or configured, as the tool relies on it to resolve change contexts and file paths. Additionally, it is not intended for unstructured documentation outside the openspec ecosystem.