How do I ensure the changes are correct?

Claude will provide a summary of all added, modified, or removed requirements after the sync. It is recommended to use Git to review and commit these changes.

Does this skill require external dependencies?

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

What is a delta spec in OpenSpec?

A delta spec is a markdown file that describes specific incremental changes—additions, modifications, or removals—to a requirement without needing to redefine the entire document.

What happens if a capability spec doesn't exist yet?

If a main spec file does not exist for a capability, the skill will automatically create it and populate it with the requirements defined in the delta spec.

Does this skill overwrite my existing documentation?

No, the skill uses intelligent merging to only update the specific requirements or scenarios mentioned in the delta spec, preserving all other existing content.

OpenSpec Specification Sync

Name: OpenSpec Specification Sync
Author: ValorVie

byValorVie

•

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

Syncs incremental requirement changes from delta specifications to main project documentation using intelligent merging.

This skill automates the process of updating master project specifications with incremental changes (deltas) defined in the OpenSpec format. It enables Claude to act as an agent that reads specific modifications—such as added, renamed, or deleted requirements—and merges them intelligently into the core documentation files. By preserving existing content and only applying relevant updates like new scenarios or description tweaks, it ensures that project requirements remain synchronized with development progress without manual copy-pasting or risky file overwriting.

主な機能

01Intelligent merging of requirements and scenarios into existing files

02Generates detailed summaries of all changes made to capability specs

03Maintains existing documentation context while applying partial updates

043 GitHub stars

05Support for adding, modifying, removing, and renaming requirements

06Automatic discovery of delta specs within the OpenSpec file structure

ユースケース

01Updating master project documentation after completing a feature spike

02Automating the synchronization of capability specs during complex refactoring phases

03Merging stakeholder requirement changes into the main specification repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add valorvie/custom-skills openspec-sync-specs

For use in Claude.ai and ChatGPT

Download Skill