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

The skill will automatically create a new main spec file for that capability, including a brief purpose section and the requirements defined in the delta.

Can I choose which feature changes to sync?

Yes, if multiple changes are available or if the context is unclear, the skill will prompt you to select the specific change you wish to sync using the AskUserQuestion tool.

Does this skill require a specific CLI tool?

Yes, this skill requires the openspec CLI to be installed in your environment to list and manage specification deltas.

Will it overwrite my entire specification file?

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

OpenSpec Specification Sync

Name: OpenSpec Specification Sync
Author: ValorVie

byValorVie

•

开发者工具

Syncs incremental specification changes from feature deltas into the main project documentation using intelligent merging.

The OpenSpec Specification Sync skill automates the complex process of updating primary project documentation with incremental changes developed in feature-specific delta specs. By leveraging Claude's reasoning, the skill performs intelligent merging—such as adding specific scenarios to existing requirements or renaming blocks—rather than simple file overwriting. This ensures that your 'source of truth' for requirements stays perfectly aligned with active development while maintaining the integrity of existing documentation context.

主要功能

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

02Preservation of existing spec content not targeted by the delta

033 GitHub stars

04Idempotent operations to ensure consistent results across multiple runs

05Interactive change selection with user-driven confirmation prompts

06Automated detection of delta spec files via openspec CLI integration

使用场景

01Refactoring requirement names and removing deprecated features across multiple capabilities

02Adding specific test scenarios to existing specifications without manual copy-pasting

03Updating master documentation with new feature requirements after a development cycle

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