openspec-sync
Sync delta specs from a change into main specs using `/opsx:sync`, without archiving the change. Use when the user says "sync specs", "merge specs to main", "/opsx:sync", or needs to update main specs mid-change.
How do I install this agent skill?
npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-syncIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates synchronizing specification files between directories. It presents a low risk of indirect prompt injection because it processes user-provided data from change folders and merges it into the main project specifications, which could potentially contain embedded instructions that influence the agent's behavior during subsequent tasks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
OpenSpec Sync Skill
Use /opsx:sync to merge delta specs from a change into the main openspec/specs/ directory without archiving the change. The change remains active after sync. This is optional — openspec-archive handles syncing automatically when archiving.
When to Use
- Long-running change where the user wants specs in main before archiving.
- Multiple parallel changes need updated base specs.
- The user wants to review/preview the merge separately before archiving.
Prerequisites
- An active change with delta specs in
specs/.
Workflow
-
Run sync
/opsx:sync— sync the current/inferred change./opsx:sync <change-name>— sync a specific change.
-
What happens
- Reads delta specs from the change folder.
- Parses ADDED / MODIFIED / REMOVED sections.
- Merges changes into
openspec/specs/. - Preserves existing content not mentioned in the delta.
- The change remains active (not archived).
-
Verify
- Review the updated specs in
openspec/specs/.
- Review the updated specs in
Outputs
- Updated
openspec/specs/with delta changes merged. - Change remains active in
openspec/changes/<name>/.
Next Steps
- Continue working on the change, or use openspec-archive when done.
Troubleshooting
- "No delta specs": The change has no
specs/directory; create specs via openspec-continue or openspec-ff first. - Conflicts with other changes: Sync handles merging at the requirement level; if two changes modify the same requirement, the latest sync wins.
References
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/full-stack-skills/openspec-skills/openspec-sync">View openspec-sync on skillZs</a>