How do I install the Archive skill?

Run npx skillmds@latest add etanhey/archive in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Archive safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Archive?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Archive free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Archive?

EtanHey (@etanhey) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Archive by etanhey — Agent Skill

Name: Archive
Author: EtanHey

File contents

Archive PRD Stories

Archive completed stories to docs.local/prd-archive/ with full history preservation. Optionally reset the working PRD for a fresh start.

Available Scripts

Run these directly - standalone, no ralph.zsh dependency:

Script	Purpose	Usage
`scripts/archive-snapshot.sh`	Create archive snapshot	`bash ~/.claude/skills/archive/scripts/archive-snapshot.sh`
`scripts/cleanup-completed.sh`	Archive + remove completed	`bash ~/.claude/skills/archive/scripts/cleanup-completed.sh`

Quick Actions

What you want to do	Workflow
Archive current PRD state (snapshot)	workflows/archive-snapshot.md
Remove completed stories (cleanup)	workflows/cleanup-completed.md

What Gets Archived

Each archive creates a timestamped directory:

docs.local/prd-archive/20260123-153000/
├── index.json           # PRD index at time of archive
├── stories/             # All story files (completed + pending)
│   ├── US-001.json
│   ├── US-002.json
│   └── ...
└── progress.txt         # Ralph progress log

Cleanup Behavior

When cleanup is triggered (via --clean or confirming prompt):

Completed stories deleted - All *.json files where passes=true
Index reset - Stats reset, pending array rebuilt from remaining stories
Progress cleared - progress.txt replaced with fresh start header

History is always preserved - The archive contains full state before cleanup.

Safety Notes

Always archives first - Cleanup only happens after successful archive
Blocked stories preserved - Stories in blocked array are kept
Pending stories preserved - Only completed (passes=true) stories removed
Reversible - Full state available in docs.local/prd-archive/

---name: archivedescription: Plan sprint transitions, archive work, reset PRD. Triggers: archive, cleanup, sprint transition, reset PRD.---# Archive PRD Stories> Archive completed stories to `docs.local/prd-archive/` with full history preservation. Optionally reset the working PRD for a fresh start.## Available ScriptsRun these directly - standalone, no ralph.zsh dependency:| Script | Purpose | Usage ||--------|---------|-------|| `scripts/archive-snapshot.sh` | Create archive snapshot | `bash ~/.claude/skills/archive/scripts/archive-snapshot.sh` || `scripts/cleanup-completed.sh` | Archive + remove completed | `bash ~/.claude/skills/archive/scripts/cleanup-completed.sh` |---## Quick Actions| What you want to do | Workflow ||---------------------|----------|| Archive current PRD state (snapshot) | [workflows/archive-snapshot.md](workflows/archive-snapshot.md) || Remove completed stories (cleanup) | [workflows/cleanup-completed.md](workflows/cleanup-completed.md) |---## What Gets ArchivedEach archive creates a timestamped directory:```docs.local/prd-archive/20260123-153000/├── index.json # PRD index at time of archive├── stories/ # All story files (completed + pending)│ ├── US-001.json│ ├── US-002.json│ └── ...└── progress.txt # Ralph progress log```---## Cleanup BehaviorWhen cleanup is triggered (via `--clean` or confirming prompt):1. **Completed stories deleted** - All `*.json` files where `passes=true`2. **Index reset** - Stats reset, pending array rebuilt from remaining stories3. **Progress cleared** - `progress.txt` replaced with fresh start header**History is always preserved** - The archive contains full state before cleanup.---## Safety Notes1. **Always archives first** - Cleanup only happens after successful archive2. **Blocked stories preserved** - Stories in blocked array are kept3. **Pending stories preserved** - Only completed (passes=true) stories removed4. **Reversible** - Full state available in `docs.local/prd-archive/`

Frequently asked questions

Archive