Does this skill overwrite my existing documentation?

No, it performs 'intelligent merging.' Claude reads the intent of the delta and only updates the specific sections or scenarios mentioned, preserving the rest of your main specification content.

Are there any prerequisites for using this skill?

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

What is a delta spec in OpenSpec?

A delta spec is a markdown file containing proposed changes—additions, modifications, or removals—to your project's main specifications, usually stored within a specific 'change' directory.

Can it create new specification files from scratch?

Yes, if a delta spec refers to a capability that does not yet exist in the main specs folder, the skill will automatically create the new file with the appropriate headers and requirements.

How does Claude handle ambiguous change names?

If a change name is not provided or is ambiguous, the skill will run a list command and use the AskUserQuestion tool to ensure the user selects the correct change set.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: ruan-cat

byruan-cat

•

学習とドキュメンテーション

Synchronizes incremental specification changes from delta files into main project documentation using intelligent AI-driven merging.

The OpenSpec Sync Specs skill enables Claude to act as an intelligent documentation architect, merging proposed requirement changes into a project's core specifications. Instead of performing simple text replacement, it executes context-aware updates—such as adding specific scenarios or renaming requirements—while preserving existing content not targeted by the change. This skill is essential for teams maintaining 'living documentation,' allowing developers to track changes in isolation before integrating them into the master specification set with high precision.

主な機能

01Interactive change selection via OpenSpec CLI integration

02Automatic generation of new specification files for new capabilities

03Automated detection of added, modified, removed, and renamed specs

043 GitHub stars

05Partial updates that preserve existing scenarios and documentation context

06Intelligent delta-to-main merging of software requirements

ユースケース

01Updating existing requirements with new test scenarios without manual copy-pasting

02Merging feature-branch documentation changes into the master project specification

03Maintaining a structured audit trail of specification changes before permanent integration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ruan-cat/monorepo openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill