Can I use this to create new specification files?

Yes, if a capability described in a delta spec does not yet exist in the main specs folder, the skill will automatically create a new spec file for it.

Is the sync process automated or interactive?

It is agent-driven but includes guardrails; if multiple changes are available, it will prompt the user to select the correct context before proceeding.

What is an OpenSpec delta spec?

A delta spec is a temporary file that captures proposed changes (additions, modifications, or removals) to a specific software capability before they are merged into the main documentation.

Does this skill overwrite my existing documentation?

No, it uses 'intelligent merging' to add or modify specific lines and scenarios while preserving existing content that isn't mentioned in the delta spec.

Do I need any external tools for this skill?

Yes, this skill requires the OpenSpec CLI to be installed and available in your environment to list and read specification files.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: pabloimrik17

bypabloimrik17

0•

Learning & Documentation

Synchronizes incremental delta specification changes into main project documentation using intelligent merging logic.

OpenSpec Sync Specs is an agent-driven utility designed to bridge the gap between proposed changes and main project specifications. It empowers Claude to intelligently parse delta specs—specifically tracking added, modified, removed, or renamed requirements—and apply those updates directly to the primary specification files. By utilizing a selective merging process rather than a wholesale replacement, the skill ensures that existing scenarios and context remain intact while precisely integrating new behavioral logic. This is an essential tool for teams using specification-driven development to maintain a single source of truth without manual documentation overhead.

Key Features

01Interactive change selection via the AskUserQuestion tool

02Intelligent merging of requirements and scenarios without overwriting unrelated content

03Idempotent execution ensuring consistent results across multiple runs

04Automated discovery of delta specs via OpenSpec CLI integration

050 GitHub stars

06Support for full requirement lifecycle: ADDED, MODIFIED, REMOVED, and RENAMED

Use Cases

01Integrating new test scenarios into existing requirement blocks for better coverage

02Managing large-scale specification renames or removals across multiple capabilities

03Updating main project documentation after completing a feature design phase

Key Features

01Interactive change selection via the AskUserQuestion tool

02Intelligent merging of requirements and scenarios without overwriting unrelated content

03Idempotent execution ensuring consistent results across multiple runs

04Automated discovery of delta specs via OpenSpec CLI integration

050 GitHub stars

06Support for full requirement lifecycle: ADDED, MODIFIED, REMOVED, and RENAMED

Use Cases

01Integrating new test scenarios into existing requirement blocks for better coverage

02Managing large-scale specification renames or removals across multiple capabilities

03Updating main project documentation after completing a feature design phase