Does this skill overwrite my entire main spec file?

No, it performs an intelligent merge, updating only the specific sections mentioned in the delta while preserving other existing content and scenarios.

Is the openspec CLI required to use this skill?

Yes, this skill relies on the openspec CLI to list available changes and locate the relevant spec directories within your project.

What happens if the main spec file doesn't exist yet?

The skill will automatically create a new main spec file for the capability and populate it with the requirements defined in the delta spec.

What is a delta spec in OpenSpec?

A delta spec represents specific changes (additions, modifications, or removals) to a requirement made during a particular feature development cycle.

Can I choose which change to sync?

Yes, if a change name isn't provided or clear from context, the skill will prompt you to select from a list of available changes using the openspec tool.

OpenSpec Specs Sync

Name: OpenSpec Specs Sync
Author: ValorVie

byValorVie

•

Content Management

Synchronizes incremental specification changes into main project documentation using intelligent agent-driven merging.

The openspec-sync-specs skill empowers Claude to act as a documentation architect by merging 'delta specs' into a project's primary specification files. Instead of simple text overwriting, it performs intelligent merging—adding new scenarios, updating existing requirements, and handling renames or deletions while preserving surrounding context. This ensures that the source of truth for project requirements stays up-to-date with feature-specific changes without requiring manual copy-pasting or risking the loss of existing documentation.

Key Features

01Intelligent merging of requirements and scenarios without overwriting files

023 GitHub stars

03Automated delta spec detection from specific change directories

04Automatic creation of new main spec files for new capabilities

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

06Interactive change selection via openspec CLI integration

Use Cases

01Maintaining a synchronized source of truth in an AI-driven development workflow

02Incorporating new edge-case scenarios into existing documentation

03Updating main project requirements after completing a specific feature change

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