Does this skill require the OpenSpec CLI?

Yes, this skill relies on the openspec CLI to list changes and navigate the directory structure of your specifications.

Is the operation idempotent?

Yes, running the sync operation multiple times will produce the same result, ensuring your main specs are consistent with the delta state.

What is a delta spec in this context?

A delta spec is a markdown file within the OpenSpec framework that defines specific changes (additions, modifications, or removals) to be applied to a main specification.

Will it overwrite my existing main specifications?

No, the skill performs an intelligent merge. It only updates the specific requirements mentioned in the delta and preserves all other existing content.

Can it handle renamed requirements?

Yes, it specifically handles RENAMED requirements by finding the old requirement name and updating it to the new name within the main spec.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: ValorVie

byValorVie

•

콘텐츠 관리

Synchronizes delta specifications from a change branch to main project requirements using intelligent agent-driven merging.

This skill automates the process of updating project documentation by merging granular 'delta specs' into the main specification files. It utilizes Claude's reasoning capabilities to perform intelligent merging—such as adding specific scenarios to existing requirements or handling renames—without requiring manual copy-pasting or wholesale file replacements. By reading the intent behind changes, it ensures that your main project specifications remain the source of truth while keeping the history of individual changes organized within the OpenSpec framework.

주요 기능

01Detailed post-sync summaries of all documentation updates

02Intelligent merging of requirements and scenarios

03Automated discovery of delta specs in the OpenSpec file structure

04Support for ADDED, MODIFIED, REMOVED, and RENAMED requirement types

05Automatic creation of new main spec files for new capabilities

063 GitHub stars

사용 사례

01Updating main project documentation after a feature design change

02Maintaining synchronized specifications across multiple software capabilities

03Merging specific user scenarios from a feature branch into production requirements

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