Is the OpenSpec CLI required for this skill?

Yes, this skill requires the OpenSpec CLI to be installed and available in your environment to properly list and identify changes.

Does this skill overwrite my existing specifications?

No, it performs intelligent merging. It reads both the delta and the main spec to apply specific changes while preserving existing scenarios and content not mentioned in the delta.

What is a delta spec in OpenSpec?

A delta spec is a markdown file that describes specific changes (additions, modifications, or removals) to a requirement rather than containing the entire document.

Can I use this to create entirely new specification files?

Yes, if a delta spec exists for a capability that does not yet have a main spec file, the skill will automatically create the new file and populate it with the requirements.

How does the skill handle ambiguous change names?

If a change name is not provided or is ambiguous, the skill will use the AskUserQuestion tool to prompt you with a list of available changes to ensure the correct ones are synced.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: ValorVie

byValorVie

•

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

Synchronizes incremental requirement changes from delta specs into main project specifications using intelligent agent-driven merging.

The openspec-sync-specs skill automates the complex process of merging 'delta specs' into a project's primary specification files. Unlike simple file overwrites, this skill performs intelligent merging—allowing for the addition of individual scenarios, modification of specific requirements, and renaming of capabilities while preserving existing content. It is ideal for teams using the OpenSpec framework who want to keep their main documentation up-to-date with active development changes without manual copy-pasting or complex manual editing.

主な機能

01Automated creation of new main specification files for newly introduced capabilities

02Intelligent merging that adds scenarios without replacing entire requirement blocks

03Agent-driven preservation of existing content not explicitly targeted for change

04Support for standardized ADDED, MODIFIED, REMOVED, and RENAMED operations

05Automatic discovery of delta spec files within the OpenSpec change directory

063 GitHub stars

ユースケース

01Updating master project documentation after completing a feature design phase

02Consolidating incremental requirement updates into a main branch's specifications

03Maintaining a single source of truth for project requirements during rapid development cycles

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