What happens if a main specification file doesn't exist?

The skill will automatically create a new specification file in the main specs directory and populate it with the requirements defined in the delta spec.

Does this skill archive changes after syncing?

No, this skill is designed to update the main specs while keeping the change active. You should use the separate archive process only when implementation is fully complete.

Does this skill require specific CLI tools?

Yes, this skill requires the OpenSpec CLI to be installed and accessible in the environment to list and manage specifications.

Is the merging process destructive to existing documentation?

No, the skill uses 'intelligent merging' which preserves existing content and scenarios that are not explicitly mentioned in the delta spec for modification or removal.

OpenSpec Sync

Name: OpenSpec Sync
Author: mvdmakesthings

bymvdmakesthings

0•

Productivity & Workflow

Synchronizes incremental specification changes into main project documentation using intelligent agent-driven merging.

The openspec-sync-specs skill streamlines the lifecycle of software requirements by merging incremental 'delta' changes from active development tasks into a project's main specification files. Built for the OpenSpec framework, it enables Claude to intelligently parse added, modified, or removed requirements and scenarios, ensuring that core documentation stays in sync with evolving features without requiring manual file management or wholesale overwriting. It is particularly useful for teams maintaining live specifications alongside active development branches.

Key Features

010 GitHub stars

02Preservation of existing scenarios while adding new ones to existing requirements

03Intelligent merging of requirement deltas into main specification files

04Interactive change selection with idempotent operations to prevent duplicate entries

05Automatic creation of missing capability spec files with standardized headers

06Support for granular requirement updates: ADDED, MODIFIED, REMOVED, and RENAMED

Use Cases

01Maintaining a single source of truth for specifications within the OpenSpec ecosystem

02Merging experimental user scenarios into the official technical documentation

03Updating project-wide requirements after finalizing a specific feature design

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mvdmakesthings/claude-marketplace openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill