Is the OpenSpec CLI required to use this skill?

Yes, this skill relies on the openspec CLI to list changes and locate the correct directory structure for syncing.

What happens if I run the sync multiple times?

The operation is idempotent, meaning running it multiple times with the same delta spec will result in the same state, preventing duplicate requirements or scenarios.

What is a delta spec in OpenSpec?

A delta spec is a markdown file that captures specific changes—additions, modifications, or removals—intended for a requirement, rather than representing the entire specification.

Does this skill overwrite my existing main specs?

No, the skill performs an intelligent merge. It reads both the delta and the main spec, applying only the relevant changes while preserving any existing content not mentioned in the delta.

OpenSpec Sync

Name: OpenSpec Sync
Author: ValorVie

byValorVie

•

Learning & Documentation

Synchronizes incremental requirement changes from delta specifications into master project documentation with intelligent merging.

The OpenSpec Sync skill enables Claude to manage the evolution of project requirements by intelligently merging feature-specific delta specs into the main project documentation. Instead of simple overwriting, this skill parses specific additions, modifications, and deletions to ensure that the source of truth is updated without losing existing context or duplicating scenarios. It is particularly useful for teams using the OpenSpec framework to maintain living documentation that evolves alongside their codebase, automating the tedious task of manual spec reconciliation.

Key Features

01Idempotent processing to ensure consistency across multiple runs

02Interactive selection of changes via integrated CLI tools

03Automated discovery of delta specs in the OpenSpec directory

04Intelligent semantic merging of requirement scenarios

05Support for ADDED, MODIFIED, REMOVED, and RENAMED blocks

063 GitHub stars

Use Cases

01Merging feature-specific requirement changes into a master specification file

02Cleaning up deprecated requirements across multiple project capabilities

03Adding new test scenarios to existing requirements without manual copy-pasting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add valorvie/custom-skills openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill