Is this a simple file overwrite or a smart merge?

It is a smart merge. The skill uses agent-driven logic to update specific sections, add scenarios, or rename requirements while preserving existing content that isn't mentioned in the update.

What does OpenSpec Sync Specs actually do?

It reads incremental requirement changes—such as updates, additions, or removals—from a specific change folder and applies them intelligently to your project's main specification files.

How do I choose which change to synchronize?

If you don't provide a change name, the skill will list all available changes from your directory and prompt you to select the correct one via an interactive question.

What happens if a capability doesn't exist in the master spec?

The skill will automatically create a new master specification file for that capability, including a purpose section and the newly defined requirements.

Is it safe to run this tool multiple times?

Yes, the operation is designed to be idempotent. Running it multiple times with the same input will yield the same consistent result without duplicating content.

OpenSpec Specification Synchronizer

Name: OpenSpec Specification Synchronizer
Author: HerbertGao

byHerbertGao

•

Productivity & Workflow

Synchronizes incremental requirement changes into master specifications using intelligent, agent-driven merging.

OpenSpec Specification Synchronizer is a specialized Claude Code skill designed to automate the integration of incremental requirement updates into a project's master documentation. It utilizes agent-driven logic to perform smart merges, allowing for precise updates like adding specific scenarios or renaming requirements without overwriting the entire file. This tool is essential for teams following the OpenSpec methodology, ensuring that the main specification stays current with ongoing changes while maintaining historical context and manual formatting.

Key Features

01Intelligent merging of incremental requirements into master specification files

02Idempotent operations to ensure consistent results across multiple runs

03Support for adding, modifying, removing, and renaming specific requirements

04Automatic creation of new specification files for previously undefined capabilities

05Context-aware change selection with interactive user prompts

061 GitHub stars

Use Cases

01Maintaining a single source of truth for technical specifications in an evolving software project

02Updating a master specification file with new feature requirements from a specific change set

03Refining existing scenarios within a capability without duplicating or losing existing content

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add herbertgao/qsl-cardhub openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill