openspec-archive
Archive a completed change with /opsx:archive, merging delta specs into main specs and preserving the change for history. Use when the user says "archive the change", "finish up", "/opsx:archive", or "mark this change as done".
- Installs
- 102
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-archive- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads openspec-archive automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
OpenSpec Archive Skill
Use /opsx:archive to finalize a completed change. Archives by merging delta specs into the main openspec/specs/ directory and moving the change folder to openspec/changes/archive/.
When to Use
- Implementation is complete and verified.
- The user says "archive", "finish", "done with this change", "wrap up".
- After running openspec-verify (optional but recommended).
Prerequisites
- Change exists with artifacts and (ideally) completed tasks.
Workflow
-
Run archive
/opsx:archive— archive the current/inferred change./opsx:archive <change-name>— archive a specific change.
-
What happens
- Checks artifact completion status and task completion (warns if incomplete).
- Offers to sync delta specs if not already synced (see openspec-sync).
- Merges delta specs into
openspec/specs/(ADDED / MODIFIED / REMOVED sections). - Moves the change folder to
openspec/changes/archive/YYYY-MM-DD-<name>/.
-
All artifacts preserved
- The full change context (proposal, design, tasks, specs) is preserved in the archive for audit trail.
Delta Spec Merge Rules
| Section | What happens |
|---|---|
## ADDED Requirements | Appended to main spec |
## MODIFIED Requirements | Replaces existing requirement in main spec |
## REMOVED Requirements | Deleted from main spec |
Outputs
- Delta specs merged into
openspec/specs/. - Change moved to
openspec/changes/archive/YYYY-MM-DD-<name>/.
Next Steps
- Start a new change with openspec-new.
- The main specs now reflect the changes — future changes build on the updated source of truth.
Troubleshooting
- "Incomplete tasks": Archive warns but does not block. Decide whether to complete tasks first or archive as-is.
- "Delta specs not synced": Archive will prompt to sync; or run openspec-sync beforehand.
- Multiple changes to archive: Use openspec-bulk-archive instead.
References
FAQ
What does the openspec-archive skill do?
Archive a completed change with /opsx:archive, merging delta specs into main specs and preserving the change for history. Use when the user says "archive the change", "finish up", "/opsx:archive", or "mark this change as done".
How do I install openspec-archive?
Run npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-archive in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/openspec-archive/ (personal) or .claude/skills/openspec-archive/ (project).
Which AI agents can use openspec-archive?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is openspec-archive safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains openspec-archive?
It is published by full-stack-skills in full-stack-skills/openspec-skills. It has 102 recorded installs.
More from full-stack-skills/openspec-skills
openspec-apply
full-stack-skills/openspec-skills
Implement tasks from the change using /opsx:apply, working through the task list and checking off items. Use when the user says "implement", "apply the change", "/opsx:apply", or "start coding from tasks".
openspec-install
full-stack-skills/openspec-skills
Install the OpenSpec CLI globally via npm, pnpm, yarn, bun, or nix. Use when the user says "install OpenSpec", "set up OpenSpec", or "openspec command not found".
openspec-update
full-stack-skills/openspec-skills
Run openspec update to regenerate AI tool instruction files after upgrading the OpenSpec CLI. Use when the user says "update OpenSpec", "openspec update", or "refresh OpenSpec skills/commands".
openspec-initial
full-stack-skills/openspec-skills
Run openspec init to initialize OpenSpec in a project directory, creating the openspec/ folder structure and configuring AI tool integrations. Use when the user says "initialize OpenSpec", "openspec init", or "set up OpenSpec in this project".
openspec-schema
full-stack-skills/openspec-skills
Create and manage custom workflow schemas using openspec schema init/fork/validate/which. Use when the user says "create a custom workflow", "custom schema", "fork a schema", or wants to define their own artifact types and dependencies.
openspec-continue
full-stack-skills/openspec-skills
Create the next artifact in the dependency chain with /opsx:continue, building up a change incrementally. Use when the user says "continue the change", "create next artifact", "/opsx:continue", or wants step-by-step artifact creation.
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.