How do I install the Archive Analysis skill?

Run npx skillmds@latest add tomevault-io/archive-analysis 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 Analysis 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 Analysis?

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 Analysis free to use?

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

Who published Archive Analysis?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Archive Analysis by tomevault-io — Agent Skill

Name: Archive Analysis
Author: tomevault-io

Archive Analysis

Clean up workspace by archiving one-time analysis files. Auto-discovers untracked markdown files, extracts insights to task tracking, and moves files to archive/ with chronological naming. Use when user wants to clean up workspace or archive temporary documentation. Use when this capability is needed.

tomevault-io 94263db 2 files · 3.6 KB Updated Sep 17, 2026

File contents

Archive Analysis Skill

Archive temporary markdown files while preserving insights. Files are committed to git then deleted from working tree to avoid context pollution for agents doing codebase searches.

When to Use

"Archive these analysis files"
"Clean up old markdown files"
"Archive FILENAME.md"

Avoid triggering on generic "clean up my workspace" - be more specific about markdown/analysis files.

Workflow

1. Discover Files

Untracked markdown (default):

uv run ~/.claude/skills/archive-analysis/archive_utils.py analyze --mode=untracked

All markdown (comprehensive):

uv run ~/.claude/skills/archive-analysis/archive_utils.py analyze --mode=explore

Specific files:

uv run ~/.claude/skills/archive-analysis/archive_utils.py analyze FILE1.md FILE2.md

2. Decide What to Archive

Archive: One-time analysis, session notes, drafts, old reports, prepared prompts Keep: README, TODO, ARCHITECTURE, templates, actively referenced docs

3. Present Plan & Get Approval

Found 2 untracked analysis files:

Recommend archiving:
- COMPARISON.md (9 KB) - team vote analysis
- NOTES.md (5 KB) - session notes

Archive as: 2024-11-24-tin-votes-*

Insights to extract:
- Add to TODO.md: "Complete assessments for 7 topics"

Proceed?

4. Execute

Extract insights to TODO.md (or detected task system)
Create archive/ and archive/index.md if needed
Move files: mv FILE.md archive/YYYY-MM-DD-description-FILE.md
Update archive/index.md with entry
Commit: git add archive/ TODO.md && git commit -m "docs: archive [description]"
Get commit hash, update index.md with hash
Delete archived files: git rm archive/YYYY-MM-DD-*.md && git commit -m "docs: remove archived files from working tree"

5. Report

Archived 2 files (in git history, removed from working tree):
- COMPARISON.md → commit abc123
- NOTES.md → commit abc123

Insights added to TODO.md.
Retrieve with: git show abc123:archive/FILENAME.md

Key Rules

Flat structure: archive/YYYY-MM-DD-description-FILE.md (no subfolders)
Always ask before archiving
Extract insights first before archiving
Two commits: Add to archive, then delete (preserves in history, cleans working tree)
Check references: Warn if file is referenced elsewhere

Why Delete After Commit?

Files committed then deleted remain in git history but don't pollute agent context when searching the codebase. Retrieve with git show <commit>:archive/<file>.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: archive-analysisdescription: Clean up workspace by archiving one-time analysis files. Auto-discovers untracked markdown files, extracts insights to task tracking, and moves files to archive/ with chronological naming. Use when user wants to clean up workspace or archive temporary documentation. Use when this capability is needed.---# Archive Analysis SkillArchive temporary markdown files while preserving insights. Files are committed to git then deleted from working tree to avoid context pollution for agents doing codebase searches.## When to Use- "Archive these analysis files"- "Clean up old markdown files"- "Archive FILENAME.md"Avoid triggering on generic "clean up my workspace" - be more specific about markdown/analysis files.## Workflow### 1. Discover Files**Untracked markdown (default):**```bashuv run ~/.claude/skills/archive-analysis/archive_utils.py analyze --mode=untracked```**All markdown (comprehensive):**```bashuv run ~/.claude/skills/archive-analysis/archive_utils.py analyze --mode=explore```**Specific files:**```bashuv run ~/.claude/skills/archive-analysis/archive_utils.py analyze FILE1.md FILE2.md```### 2. Decide What to Archive**Archive:** One-time analysis, session notes, drafts, old reports, prepared prompts**Keep:** README, TODO, ARCHITECTURE, templates, actively referenced docs### 3. Present Plan & Get Approval```Found 2 untracked analysis files:Recommend archiving:- COMPARISON.md (9 KB) - team vote analysis- NOTES.md (5 KB) - session notesArchive as: 2024-11-24-tin-votes-*Insights to extract:- Add to TODO.md: "Complete assessments for 7 topics"Proceed?```### 4. Execute1. Extract insights to TODO.md (or detected task system)2. Create `archive/` and `archive/index.md` if needed3. Move files: `mv FILE.md archive/YYYY-MM-DD-description-FILE.md`4. Update `archive/index.md` with entry5. Commit: `git add archive/ TODO.md && git commit -m "docs: archive [description]"`6. Get commit hash, update index.md with hash7. Delete archived files: `git rm archive/YYYY-MM-DD-*.md && git commit -m "docs: remove archived files from working tree"`### 5. Report```Archived 2 files (in git history, removed from working tree):- COMPARISON.md → commit abc123- NOTES.md → commit abc123Insights added to TODO.md.Retrieve with: git show abc123:archive/FILENAME.md```## Key Rules- **Flat structure:** `archive/YYYY-MM-DD-description-FILE.md` (no subfolders)- **Always ask** before archiving- **Extract insights first** before archiving- **Two commits:** Add to archive, then delete (preserves in history, cleans working tree)- **Check references:** Warn if file is referenced elsewhere## Why Delete After Commit?Files committed then deleted remain in git history but don't pollute agent context when searching the codebase. Retrieve with `git show <commit>:archive/<file>`.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/jas-ho) — claim your Tome and manage your conversions.

Frequently asked questions