openspec-sync-specs

Merge delta spec changes into main OpenSpec specifications via intelligent agent-driven editing.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill openspec-sync-specs-codercoco-studios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openspec-sync-specs
Source: https://github.com/CoderCoco-Studios/Hyveon/tree/main/.claude/skills/openspec-sync-specs
Command: npx skills add https://github.com/CoderCoco-Studios/Hyveon --skill openspec-sync-specs-codercoco-studios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping main specifications in sync with change proposals is tedious and error-prone when done by hand. This Skill applies delta specs (ADDED, MODIFIED, REMOVED, RENAMED requirements) from an OpenSpec change directly into the main specs without archiving the change, using intelligent partial merging instead of wholesale file replacement. ## Core Features & Use Cases - Intelligent requirement merging: Adds new requirements, applies partial modifications (e.g., adding a single scenario without copying existing ones), removes deprecated requirements, and handles renames. - Store-aware operation: Discovers registered OpenSpec stores via openspec store list --json and targets the correct specs root for every read and write. - Guardrailed workflow: Uses only artifactPaths.specs.existingOutputPaths as the delta source, honors caller-narrowed subsets, fetches artifact rules once, and stops before any write on invalid instruction responses. - Use Case: After drafting a change with delta specs for a billing capability, ask the agent to sync those deltas into the main specs so the canonical documentation reflects the new requirements while the change stays active. ## Quick Start Ask the agent to sync the delta specs from a named OpenSpec change into the main specs, for example by saying "sync the specs from the add-billing change".

Frequently Asked Questions about openspec-sync-specs

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

FAQPage Schema
How do I sync OpenSpec delta specs into main specs?

Provide a change name or let the agent infer it from context. The skill runs openspec status to locate delta specs, reads each delta and corresponding main spec, then merges ADDED, MODIFIED, REMOVED, and RENAMED requirements into the main spec files.

Does syncing specs archive the OpenSpec change?

No, syncing updates main specs while the change remains active. Archiving is a separate operation you perform later once implementation is complete.

Can I sync only some delta specs instead of all of them?

Yes, you can name an explicit subset of delta spec paths to sync. The skill honors that narrowed selection and never widens it back to the full list; named paths not in existingOutputPaths are reported and skipped.

What happens if a requirement already exists in the main spec?

An ADDED requirement that already exists is treated as an implicit modification and updated to match the delta. MODIFIED entries apply partial changes such as adding scenarios while preserving content the delta does not mention.

Does openspec-sync-specs work with OpenSpec stores?

Yes, it runs openspec store list --json to discover registered stores and passes --store <id> to commands that read or write specs and changes, so main spec paths resolve against the store root rather than the local repository.