teachingai/openspec-archive
skills/openspec-skills/openspec-archive/SKILL.md
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".
$ install --global
skillsauthnpx skillsauth add teachingai/agent-skills openspec-archiveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 9:32 PM3.0s1 file scanned
SKILL.md
- name:
- openspec-archive
- description:
- 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".
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
- OpenSpec Commands: /opsx:archive
- OpenSpec Concepts: Archive
Related Skills
teachingai/nextjs
development
VerifiedTrustedCommunity
Guidance for Next.js using the official docs at nextjs.org/docs. Use when the user needs Next.js concepts, configuration, routing, data fetching, or API reference details.
284SKILL.mdUpdated Apr 14, 2026
teachingai/flask
tools
VerifiedTrustedCommunity
Provides comprehensive guidance for Flask framework including routing, templates, forms, database integration, extensions, and deployment. Use when the user asks about Flask, needs to create web applications, implement routes, or build Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/fastapi
development
VerifiedTrustedCommunity
Provides comprehensive guidance for FastAPI framework including routing, request validation, dependency injection, async operations, OpenAPI documentation, and database integration. Use when the user asks about FastAPI, needs to create REST APIs, or build high-performance Python web services.
284SKILL.mdUpdated Apr 14, 2026
teachingai/django
development
VerifiedTrustedCommunity
Provides comprehensive guidance for Django framework including models, views, templates, forms, admin, REST framework, and deployment. Use when the user asks about Django, needs to create web applications, implement models and views, or build Django REST APIs.
284SKILL.mdUpdated Apr 14, 2026