skill CX Codex

openspec-archiving — Claude Code skill: what it does and setup

Q: How to install openspec-archiving in Claude Code?

Run `npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a claude-code`. The file is saved to `~/.claude/skills/openspec-archiving/SKILL.md`.

Q: What prerequisites are checked before archiving?

The change folder must contain an `IMPLEMENTED` file, all items in `tasks.md` must be finished, and `git status` must show no uncommitted work.

Archives completed change proposals and merges requirement deltas into living project documentation following deployment.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a claude-code

Open on GitHub

What openspec-archiving does

The skill manages moving finished task folders from spec/changes/ into timestamped archive directories under spec/archive/. It starts by checking for an IMPLEMENTED marker, verifying tasks in tasks.md, and checking git status. Unfinished work will stop the process.

Next, the agent processes requirement deltas sorted by ADDED, MODIFIED, and REMOVED sections. New requirements append to living specs under spec/specs/. Modified sections get overwritten completely, while removed entries receive deprecation date notes. Finally, the source folder moves into the archive and header structures are validated.

What it helps with

move completed proposals into a timestamped archive directory
append newly added requirements from deltas into living specs
replace modified requirement blocks in specification files
document removed scenarios with deprecation comments

Example prompts for the agent

Archive the finished proposal for add-user-auth and update living specs
Check task completion for payment-gateway and move its folder to the archive
Merge specification deltas from the changes directory into living documentation

How to install openspec-archiving

1Skills CLI (Vercel)

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a claude-code

2Manually: put the files in place

~/.claude/skills/openspec-archiving/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/openspec-archiving/

1Skills CLI (Vercel)

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a codex

2Manually: put the files in place

.agents/skills/openspec-archiving/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a cursor

2Manually: put the files in place

.cursor/skills/openspec-archiving/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install forztf/open-skilled-sdd openspec-archiving

2Manually: put the files in place

.github/skills/openspec-archiving/SKILL.md

1Skills CLI (Vercel)

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a gemini-cli

2Platform CLI

gemini skills install https://github.com/forztf/open-skilled-sdd --path skills/openspec-archiving

Manually: put the files in place

.devin/skills/openspec-archiving/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about openspec-archiving

How to install openspec-archiving in Claude Code?

Run npx skills add forztf/open-skilled-sdd --skill openspec-archiving -a claude-code. The file is saved to ~/.claude/skills/openspec-archiving/SKILL.md.

What does openspec-archiving do?

It validates completion status, relocates change directories into spec/archive/, and applies delta modifications to Markdown specs in spec/specs/.

What prerequisites are checked before archiving?

The change folder must contain an IMPLEMENTED file, all items in tasks.md must be finished, and git status must show no uncommitted work.

Similar skills

All skills for Writing and docs →

grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. 414,180installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. 1,038,491installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. 990,453installs domain-modeling Matt Pocock This skill sharpens project terminology, maintains GLOSSARY.md, and records selected architecture decisions in ADRs. Use it while the domain model is changing. 876,391installs

From the same set4

openspec-implementation Executes approved OpenSpec proposals sequentially, testing each task before marking it done and tracking everything in TodoWrite. CX Codex +1 1,400installs openspec-proposal-creation Builds a structured change proposal: proposal.md, tasks.md and spec-delta.md with requirements in EARS format. Useful when a feature needs writing down before anyone codes it. CX Codex +1 1,200installs openspec-context-loading This skill finds specs, active changes and requirements in a project and hands the agent a ready summary. Useful when you need to know what OpenSpec already describes. CX Codex +1 1,100installs