Archive
- 710 installs
- 1 repo stars
- Updated May 26, 2026
- camacho/ai-skills
archive is an agent skill that closes completed project plans by capturing outcomes, lessons learned, and renaming plan files to .done.md in the ai-workspace/plans directory.
About
archive is a camacho ai-skills workflow for formally closing agent-driven project plans. The skill locates the most recent non-archived plan in $WORKTREE/ai-workspace/plans/, reads planned scope, gathers what worked and what did not from the user or git log context, fills an Outcomes & Learnings section, and renames the file to .done.md. Developers reach for archive when a worktree initiative finishes and the plan should persist as a completed record rather than an active todo. The skill errors if the plan is already archived, preventing duplicate closure, and resolves WORKTREE from the session CWD or git rev-parse --show-toplevel.
- Automatically locates the most recent non-archived plan in ai-workspace/plans/
- Gathers outcomes by prompting the user or inferring from git history
- Inserts standardized Outcomes & Learnings section with What Worked, What Didn't, and Learnings
- Renames plan to .done.md, stages it, and creates a git commit with Co-Authored-By signature
- Prevents duplicate archiving with clear error when file is already .done.md
Archive by the numbers
- 710 all-time installs (skills.sh)
- Ranked #605 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
npx skills add https://github.com/camacho/ai-skills --skill archiveAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 710 |
|---|---|
| repo stars | ★ 1 |
| Security audit | 3 / 3 scanners passed |
| Last updated | May 26, 2026 |
| Repository | camacho/ai-skills ↗ |
How do you archive a completed AI project plan?
Close completed project plans by capturing real outcomes, lessons learned, and automatically archiving them as.done.md files.
Who is it for?
Developers using camacho ai-workspace plan files who want structured closure after finishing a worktree initiative.
Skip if: Repositories without ai-workspace/plans/ markdown plans or tasks needing git tagging instead of plan archival.
When should I use this skill?
A project plan in ai-workspace/plans/ is complete and the developer wants outcomes and lessons captured before starting the next task.
What you get
A renamed .done.md plan file with documented outcomes, lessons learned, and completion status in ai-workspace/plans/.
- .done.md archived plan
- outcomes and learnings section
Files
Inputs
WORKTREE: absolute path to current worktree (resolve from session CWD orgit rev-parse --show-toplevel)- Plan file path (default: most recent non-
.done.mdin$WORKTREE/ai-workspace/plans/)
Steps
1. Find the plan file:
ls -t "$WORKTREE/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1If plan is already .done.md → error: "Already archived."
2. Read the plan file to understand what was planned.
3. Gather outcomes: Ask the user (or infer from git log + branch context):
- What worked well?
- What didn't go as planned?
- What would you do differently?
If user skips → write "Outcomes: not recorded" (don't block).
4. Write Outcomes & Learnings section to the plan file:
## Outcomes & Learnings
**Completed**: [date]
### What Worked
- [bullet points]
### What Didn't
- [bullet points]
### Learnings
- [bullet points]5. Rename to .done.md:
git -C "$WORKTREE" mv ai-workspace/plans/<name>.md ai-workspace/plans/<name>.done.md6. Commit the archive:
git -C "$WORKTREE" add ai-workspace/plans/<name>.done.md
git -C "$WORKTREE" commit -m "docs: archive plan <name>
Co-Authored-By: Claude <model>"Output: Confirmation that the plan is archived with path to .done.md file.
Related skills
Grill MeHave an agent relentlessly pressure-test their plan or design until every decision branch is resolved and shared understanding is reached.691k196kGrill With DocsPressure-test architecture decisions against their live codebase and living documentation before writing production code.585k196k
Lark CalendarLet their coding agents read, create, and manage events inside Lark (Feishu) Calendar directly from natural language instructions.493kLark ImLet their coding agent send instant notifications, post updates, and receive commands directly inside Lark (Feishu) workspaces.493kLark ContactLet their AI coding agents read and write contacts, send messages, and manage user data inside Lark (Feishu).493kLark AttendanceAutomatically fetch and report daily attendance data from Lark (Feishu) into their own tools or agents.493kFAQ
Where does archive store completed plans?
archive stores completed plans in the worktree ai-workspace/plans/ directory, renaming the active .md file to a .done.md suffix after Outcomes & Learnings are filled.
What happens if a plan is already archived?
archive returns an error stating the plan is already archived when the target file already carries the .done.md suffix, preventing duplicate closure.
Is Archive safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.