How do I know what changes were made?

After every sync operation, the skill provides a detailed summary listing which capabilities were updated and exactly which requirements were added, modified, or removed.

Is the OpenSpec CLI required to use this skill?

Yes, this skill requires the openspec CLI to be installed and available in your environment to list and manage change specs.

What happens if a requirement already exists in the main spec?

If an ADDED requirement already exists, the skill updates it to match the delta. If a requirement is MODIFIED, it applies changes like adding new scenarios without deleting existing ones.

Do I need to provide a change name every time?

Not necessarily. If you omit the name, the skill will try to infer it from your conversation context or provide a list of available changes for you to choose from.

Does this skill overwrite my entire specification file?

No, it performs an intelligent merge. It only updates the specific requirements and scenarios mentioned in the delta spec while preserving any existing content not mentioned.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

コンテンツ管理

Syncs delta specification changes into main project specifications using intelligent requirement merging.

The openspec-sync-specs skill automates the process of updating your project's main specifications with incremental changes found in delta specs. Rather than performing a simple file replacement, it intelligently merges new scenarios, updates modified requirements, and handles renames or removals while preserving existing content. This skill is essential for maintaining a clean, up-to-date source of truth for project requirements during active development cycles without losing historical context or manual formatting.

主な機能

01Intelligent merging of requirements and scenarios without overwriting files

020 GitHub stars

03Automatic detection and mapping of delta specs to main specification files

04Idempotent execution ensuring consistent results across multiple runs

05Comprehensive summary reports of all capability updates and changes

06Support for requirement operations: ADDED, MODIFIED, REMOVED, and RENAMED

ユースケース

01Keeping main specifications synchronized with active development branches

02Merging feature-specific changes into main documentation after a design phase

03Updating existing project requirements with new acceptance criteria scenarios

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