
Openspec Sync Specs
This syncs delta specs from an openspec change back into your main specs without archiving the change. It reads the delta files (which mark requirements as ADDED, MODIFIED, REMOVED, or RENAMED) and intelligently merges them into your main spec files. The key bit is that it does smart merging instead of blind replacement, so you can add a single scenario to an existing requirement without copying everything else over. It prompts you to pick which change to sync if you don't specify one, then walks through each capability's delta and applies the changes. Useful when you want to keep a change branch active but pull its spec updates into main as you go.
- skills.sh installs
- 153
- GitHub stars
- 6.4K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add pbh-btn/peerbanhelper --skill openspec-sync-specs --agent claude-codeInstalls into .claude/skills of the current project.
Files
Sync delta specs from a change to main specs.
This is an agent-driven operation - you will read delta specs and directly edit main specs to apply the changes. This allows intelligent merging (e.g., adding a scenario without copying the entire requirement).
Input: Optionally specify a change name. If omitted, check if it can be inferred from conversation context. If vague or ambiguous you MUST prompt for available changes.
Steps
-
If no change name provided, prompt for selection
Run
openspec list --jsonto get available changes. Use the AskUserQuestion tool to let the user select.Show changes that have delta specs (under
specs/directory).IMPORTANT: Do NOT guess or auto-select a change. Always let the user choose.
-
Find delta specs
Look for delta spec files in
openspec/changes/<name>/specs/*/spec.md.Each delta spec file contains sections like:
## ADDED Requirements- New requirements to add## MODIFIED Requirements- Changes to existing requirements## REMOVED Requirements- Requirements to remove## RENAMED Requirements- Requirements to rename (FROM:/TO: format)
Sponsors
Details
- Repository
- github.com/pbh-btn/peerbanhelper
- First seen
- Jun 3, 2026