cleanup
Archive processed inbox items. Activate when user says "cleanup", "archive inbox". Moves session summaries to archive, keeps inbox clean for new items.
When & Why to Use This Skill
This Claude skill automates workspace organization by archiving processed inbox items and session summaries into structured, date-based directories. It optimizes agent performance by maintaining a clutter-free environment, ensuring that only active tasks remain in the primary inbox while historical data is safely preserved for future reference.
Use Cases
- Automated Workspace Cleanup: Use the 'cleanup' command to instantly move completed session summaries to a monthly archive, preventing information overload in the active directory.
- Systematic Knowledge Archiving: Automatically organize historical session data into YYYY-MM folders, making it easier to retrieve past summaries and audit agent activities.
- File System Maintenance: Safely remove ephemeral files and temporary logs after processing to ensure the agent's environment remains efficient and focused on new tasks.
| name | cleanup |
|---|---|
| description | Archive processed inbox items. Activate when user says "cleanup", "archive inbox". Moves session summaries to archive, keeps inbox clean for new items. |
| allowed-tools | Bash, 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