What is a delta spec in the OpenSpec framework?

A delta spec is a markdown file located within an OpenSpec change directory that captures specific modifications—such as new, edited, or deleted requirements—rather than the entire specification document.

Is the syncing process reversible?

The skill modifies files on your local disk. You can review the changes and use Git or your version control system to revert them if the merge result is not what you expected.

What happens if I forget the name of the change I want to sync?

If no change name is provided, the skill will automatically query the openspec CLI for a list of available changes and prompt you to select the correct one from the list.

Will this skill overwrite my existing documentation?

No, it performs an intelligent merge. It specifically targets the requirements mentioned in the delta and preserves all other existing content, scenarios, and descriptions in your main specs.

Does this skill require any external dependencies?

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

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

学习与文档

Syncs incremental specification changes from delta files into main project specifications using intelligent merging.

The OpenSpec Sync Specs skill automates the process of updating core project documentation by merging proposed changes from delta specifications into the main specification files. It empowers Claude to act as a documentation agent that intelligently interprets added, modified, or removed requirements, ensuring that new scenarios are integrated without overwriting existing, unrelated content. This skill is essential for teams using the OpenSpec framework to maintain a 'living documentation' system, as it handles the tedious task of cross-referencing change sets with the master record while preserving the context and structure of the original specs.

主要功能

010 GitHub stars

02Interactive change selection via integration with the openspec CLI

03Intelligent merging of requirements and scenarios into existing markdown files

04Support for requirement lifecycle operations including ADDED, MODIFIED, REMOVED, and RENAMED

05Automated detection and reading of delta specification files

06Automatic creation of new main specification files for previously undefined capabilities

使用场景

01Merging approved feature changes from a specific development branch into the main project requirements

02Automating the migration of requirement scenarios from change-sets to the master specification library

03Maintaining consistent technical documentation by syncing incremental updates across multiple capabilities

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add blackbelttechnology/judo-generator-commons openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill