Are there any prerequisites for using openspec-sync-specs?

Yes, this skill requires the openspec CLI to be installed and accessible in your environment to list and manage specification changes.

What are delta specs in OpenSpec?

Delta specs are incremental requirement changes located in the openspec/changes directory that define specific additions, modifications, or removals for a particular feature change.

What happens if I run the synchronization twice?

The operation is designed to be idempotent. Running it a second time on the same change will result in no further modifications, as the main specs will already match the intended state.

Does this skill overwrite my existing main specifications?

No, it performs intelligent merging. It reads both the delta and main specs, then applies only the necessary changes while preserving existing scenarios and content not mentioned in the delta.

OpenSpec Spec Synchronization

Name: OpenSpec Spec Synchronization
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

Synchronizes incremental requirement changes from delta specs into main specification files using intelligent merging.

This skill automates the process of updating a project's primary documentation by applying 'delta specs'—incremental changes—to the repository's main specification files. Instead of basic file overwriting, it uses Claude's reasoning to intelligently merge new scenarios, modify existing requirements, and handle renames while preserving untouched content. It is an essential tool for teams using the OpenSpec framework who need to maintain a rigorous, up-to-date source of truth for their requirements without the overhead of manual document maintenance.

Key Features

010 GitHub stars

02Intelligent merging of requirements and scenarios

03Automated creation of new capability specifications

04Idempotent execution to ensure consistent results across multiple runs

05Interactive change selection via openspec CLI integration

06Support for adding, modifying, removing, and renaming requirements

Use Cases

01Updating main project requirements after completing a specific feature branch

02Integrating new user scenarios into existing requirement documents

03Managing the evolution of complex technical specifications without manual editing

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add blackbelttechnology/judo-runtime-core openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill