cleanup

Archive processed inbox items. Activate when user says "cleanup", "archive inbox". Moves session summaries to archive, keeps inbox clean for new items.

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill automates the organization of your digital workspace by archiving processed session summaries and clearing ephemeral files. It ensures a clutter-free 'inbox' environment, systematically moving older items into a structured monthly archive to maintain high operational efficiency and clear context for new tasks.

Use Cases

  • Automated Workspace Maintenance: Periodically move processed session summaries to a time-stamped archive to prevent file clutter in the active working directory.
  • Context Optimization: Clear out ephemeral files and old logs to ensure the AI agent focuses only on current, relevant items during new sessions.
  • Long-term Data Organization: Automatically categorize historical session data into monthly folders (e.g., 2025-11) for easy retrieval and systematic record-keeping.
namecleanup
descriptionArchive processed inbox items. Activate when user says "cleanup", "archive inbox". Moves session summaries to archive, keeps inbox clean for new items.
allowed-toolsBash, Read

Cleanup (Inbox Archive)

Archive processed inbox items to keep inbox clean for new work.

When to Activate

  • User says: "cleanup", "archive inbox", "clean inbox"
  • After learn skill completes
  • When inbox has accumulated processed items

Process

1. Check Inbox Contents

ls -la inbox/
ls -la inbox/session-summaries/ 2>/dev/null

2. Archive Session Summaries

Move processed summaries to monthly archive:

# Create archive directory
mkdir -p inbox/session-summaries/archive/$(date +%Y-%m)

# Move files older than 1 hour (not currently being written)
find inbox/session-summaries/ -maxdepth 1 -name "*.md" -mmin +60 -exec mv {} inbox/session-summaries/archive/$(date +%Y-%m)/ \;

3. Clean Other Processed Items

# Remove ephemeral files after processing
rm -f inbox/role-review-needed.txt 2>/dev/null

4. Verify Clean State

ls inbox/

5. Report

Inbox cleanup complete.

Archived:
- [N] session summaries → inbox/session-summaries/archive/YYYY-MM/

Inbox ready for new items.

Archive Structure

inbox/
├── session-summaries/
│   ├── archive/
│   │   ├── 2025-11/
│   │   └── 2025-12/
│   └── (empty - ready for new)
└── (clean)

Safety

  • Only archive files older than 1 hour
  • Never delete session summaries (archive instead)
  • Idempotent - safe to run multiple times