openspec-sync-specs

Merge delta specification changes into main project spec files.

Updated Jan 18, 2026
One-click install
npx skills add https://github.com/tungnguyen10/iuh_department --skill openspec-sync-specs-tungnguyen10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/tungnguyen10/iuh_department/tree/main/.agents/skills/openspec-sync-specs
Command: npx skills add https://github.com/tungnguyen10/iuh_department --skill openspec-sync-specs-tungnguyen10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of merging delta specification changes from a project change into main project specs, ensuring consistent and accurate documentation updates without requiring you to archive the change first.

Core Features & Use Cases

  • Intelligent Spec Merging: Automatically apply added, modified, removed, and renamed requirements from delta specs to corresponding main specs, preserving all existing content not mentioned in the delta.
  • New Spec Creation: Generate new main spec files for capabilities that do not yet have existing specs, with placeholder purpose sections and added requirements.
  • Use Case: When you have a feature change with updated requirement scenarios that need to be reflected in the main project specs, use this Skill to apply those changes directly without rewriting entire spec files.

Quick Start

Use the openspec-sync-specs skill to sync all delta spec changes from your active feature change to the corresponding main project specs.

Frequently Asked Questions about openspec-sync-specs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically merge delta spec changes into main project specs?

You can automatically merge delta spec changes by applying added, modified, removed, and renamed requirements from delta specs directly into main project specs. This intelligent partial merging preserves all existing main spec content not covered by the delta.

What is the best way to sync requirement changes from a feature branch to core specs?

The best way to sync requirement changes is to use an automated spec-sync workflow that integrates updated feature scenarios into main specs without rewriting entire files. This eliminates manual merging errors and ensures consistent documentation updates.

Can I generate new main specification files for capabilities that do not have existing specs?

Yes, you can generate new main specification files for capabilities lacking existing specs. The process automatically creates new files with placeholder purpose sections and incorporates the added requirements from the delta specs.

How does partial spec merging handle removed and renamed requirements?

Partial spec merging handles removed and renamed requirements by intelligently applying those specific changes from the delta to the main specs. It accurately updates or deletes targeted requirements while preserving the remaining existing content.

Do I need to archive a project change before updating the main software documentation?

No, you do not need to archive a project change before updating main software documentation. You can apply delta specification changes directly to main project specs during the software development workflow without archiving first.