Can I sync changes for a specific capability only?

The skill identifies deltas based on the 'change' name. It will sync all capabilities modified within that specific change set to their respective main spec files.

What is a delta spec in OpenSpec?

A delta spec is a markdown file that captures specific changes—additions, modifications, or removals—to a requirement before they are merged into the main project specifications.

Does this skill overwrite my existing documentation?

No, it performs an intelligent merge. It reads the existing main spec and the delta spec, then only applies the specific updates mentioned, preserving any content not targeted by the change.

Is the openspec CLI required for this skill?

Yes, this skill relies on the openspec CLI to list changes and locate the appropriate directory structures within your project.

OpenSpec Specification Synchronizer

Name: OpenSpec Specification Synchronizer
Author: ValorVie

byValorVie

•

Learning & Documentation

Synchronizes incremental requirement changes into main project specifications using intelligent AI merging.

The OpenSpec Sync Specs skill automates the process of updating a project's core documentation by merging incremental 'delta' specifications into main specification files. Instead of performing a blind overwrite, it leverages Claude's reasoning to perform intelligent merges—such as adding specific scenarios to existing requirements or renaming capabilities—ensuring that the main specs accurately reflect the latest feature definitions while preserving existing context and formatting. This is ideal for teams using the OpenSpec framework to maintain a live, accurate single source of truth for their software requirements.

Key Features

01Detailed summary reporting of updated capabilities and spec changes

02Intelligent merging of ADDED, MODIFIED, REMOVED, and RENAMED requirements

03Idempotent execution ensuring consistent results across multiple runs

04Partial updates for scenarios without duplicating existing requirement blocks

05Automated discovery and prompting for available change deltas

063 GitHub stars

Use Cases

01Updating main product specifications after a feature design phase

02Propagating requirement changes from specific feature branches to central documentation

03Automating the maintenance of spec files in complex OpenSpec-managed projects

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