Does this skill overwrite my existing documentation?

No, it uses intelligent merging to apply only the changes specified in the delta while preserving any existing content, scenarios, or requirements not mentioned.

What happens if a capability doesn't exist in the main specs yet?

The skill will automatically create a new main specification file for that capability and populate it with the requirements provided in the delta spec.

Is the sync process destructive?

The process is additive and corrective based on the delta; it only removes content if specifically instructed by a 'REMOVED Requirements' section in the delta spec.

Does this skill require specific CLI tools?

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

What is a delta spec in OpenSpec?

A delta spec is a markdown file containing specific incremental changes—such as additions, modifications, or removals—intended for a software requirement rather than the full requirement text.

OpenSpec Specification Sync

Name: OpenSpec Specification Sync
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Learning & Documentation

Synchronizes incremental requirement changes from delta files into main project specifications using intelligent agent-driven merging.

This skill automates the maintenance of OpenSpec documentation by merging proposed changes from delta files directly into a project's core specifications. It enables Claude to act as an intelligent documentation manager, recognizing specific additions, modifications, removals, or renames within requirement blocks. By using an agent-driven approach rather than a simple file overwrite, it preserves existing context and allows for partial updates—such as adding a single scenario to a complex requirement—ensuring documentation stays in sync with evolving feature sets without manual copy-pasting.

Key Features

01Interactive change selection via openspec CLI integration

02Idempotent execution ensuring consistent results across multiple sync attempts

03Intelligent merging of added, modified, removed, and renamed requirements

04Agent-driven delta analysis to preserve existing documentation context

05Automated main spec creation for newly defined capabilities

060 GitHub stars

Use Cases

01Automating the synchronization of requirements to ensure documentation matches implementation intent

02Merging experimental specification changes from a change-set into the main documentation

03Updating core project requirements with new feature scenarios after a design phase

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