Do I need any external tools to use this skill?

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

Does this skill overwrite my existing documentation?

No, the skill performs an intelligent merge. It preserves existing scenarios and content not mentioned in the delta, only applying the specific changes defined in the update.

What is a delta spec in this context?

A delta spec is a markdown file within a specific change folder that outlines only the differences—additions, modifications, or removals—relative to the main project specifications.

Can it handle renamed requirements?

Yes, it specifically looks for RENAMED blocks to update requirement headers from an old name to a new one while maintaining their associated content and history.

OpenSpec Sync Specs

Name: OpenSpec Sync Specs
Author: TomazWang

byTomazWang

•

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

Synchronizes incremental specification changes from delta files into the main project documentation.

The openspec-sync-specs skill empowers Claude to intelligently merge specification updates from local change branches into a project's core documentation. By interpreting delta spec formats—including added, modified, removed, or renamed requirements—this skill automates the tedious task of updating main specs without overwriting existing context. It is particularly useful for teams using the OpenSpec framework to manage evolving requirements in brownfield projects, ensuring that the central knowledge base remains a single source of truth as features are developed and requirements evolve.

主な機能

01Delta Processing: Automatically interprets ADDED, MODIFIED, REMOVED, and RENAMED requirement blocks.

02Idempotent Operations: Ensures that running the sync multiple times results in a consistent and stable documentation state.

031 GitHub stars

04Automatic Spec Creation: Generates new capability specification files if they do not already exist.

05Context-Aware Change Selection: Prompts users to select specific changes or infers them from the active conversation.

06Intelligent Requirement Merging: Applies partial updates like new scenarios without duplicating existing content.

ユースケース

01Promoting feature-specific requirement changes to the main project documentation after a design review.

02Updating existing capabilities with new scenarios without losing established requirement context.

03Automating the consolidation of multiple specification updates within an AI-managed knowledge base.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tomazwang/deepfield openspec-sync-specs

For use in Claude.ai and ChatGPT

主な機能

01Delta Processing: Automatically interprets ADDED, MODIFIED, REMOVED, and RENAMED requirement blocks.

02Idempotent Operations: Ensures that running the sync multiple times results in a consistent and stable documentation state.

031 GitHub stars

04Automatic Spec Creation: Generates new capability specification files if they do not already exist.

05Context-Aware Change Selection: Prompts users to select specific changes or infers them from the active conversation.

06Intelligent Requirement Merging: Applies partial updates like new scenarios without duplicating existing content.

ユースケース

01Promoting feature-specific requirement changes to the main project documentation after a design review.

02Updating existing capabilities with new scenarios without losing established requirement context.

03Automating the consolidation of multiple specification updates within an AI-managed knowledge base.