Is the sync operation safe to run multiple times?

Yes, the operation is designed to be idempotent. Running it multiple times on the same change-set will result in the same final state without creating duplicate entries.

Can I use this to delete requirements?

Yes, by including a requirement under the 'REMOVED Requirements' section in your delta spec, the skill will automatically remove that entire block from the main spec.

What happens if a change name isn't provided?

The skill will attempt to infer the change name from your conversation context. If it's ambiguous, it will list available changes and ask you to select the correct one.

Do I need any external tools for this skill to work?

Yes, this skill requires the openspec CLI to be installed and configured in your environment to list and manage specifications.

Does this skill overwrite my existing main specs?

No, it uses intelligent merging to update only the specific sections mentioned in the delta, preserving all other existing content within your main specification files.

OpenSpec Sync

Name: OpenSpec Sync
Author: BlackBeltTechnology

byBlackBeltTechnology

0•

Content Management

Synchronizes delta specification changes into main project requirements using intelligent, agent-driven merging.

OpenSpec Sync is a specialized tool for maintaining project specifications by merging proposed changes (deltas) directly into main documentation files. Instead of simple file overwrites, it uses intelligent merging to add new scenarios, modify existing requirements, and handle renames while preserving the integrity of existing content. This skill is ideal for teams using the OpenSpec framework to manage evolving software requirements without manual copy-pasting or complex manual merges in documentation files.

Key Features

01Automated discovery of change-sets and specification files within the OpenSpec directory structure.

02Intelligent delta merging that updates specific scenarios without replacing entire files.

030 GitHub stars

04Support for full lifecycle operations on requirements including additions, modifications, removals, and renames.

05Idempotent operation architecture ensuring consistent results even when run multiple times.

06Agent-driven selection process that intelligently prompts for specific changes based on conversation context.

Use Cases

01Applying approved feature updates from a development branch to the main project documentation.

02Merging new acceptance criteria and scenarios into existing software requirements.

03Streamlining the transition from requirement drafting to the official project baseline.

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