maroffo/claude-forge88 installs
email-cleanup
Clean up Gmail - archive old emails, delete promotions, manage storage. Use when user wants to clean inbox, archive emails, or free up space.
How do I install this agent skill?
npx skills add https://github.com/maroffo/claude-forge --skill email-cleanupIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill automates Gmail maintenance tasks such as archiving promotional and social emails using the 'gog' command-line tool. It prioritizes safety by requiring user confirmation before processing and handling emails in small batches.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
ABOUTME: Gmail bulk cleanup - archive old emails, delete promotions, free storage
ABOUTME: Parameterized batch operations with safety-first approach
Email Cleanup Skill
Gmail: See ../_GMAIL.md for account config and commands.
Safety Rules
- NEVER delete without confirmation - show counts first
- Archive over delete - prefer archiving (recoverable)
- Batch in chunks - max 50 at a time
Cleanup Targets
| Category | Query | Action |
|---|---|---|
| Promotions | category:promotions older_than:30d | Archive |
| Social | category:social older_than:14d | Archive |
| Read updates | category:updates is:read older_than:7d | Archive |
| Large emails | larger:10M | Review individually |
| Unsubscribe candidates | unsubscribe is:read older_than:30d | Review |
Workflow
Step 1: Count each category
gog gmail search "<query>" --account=maroffo@gmail.com --json | jq '.resultSizeEstimate'
Step 2: Present summary table with counts and suggested actions
Step 3: Execute (with confirmation)
THREADS=$(gog gmail search "<query>" --account=maroffo@gmail.com --json --max=50 | jq -r '.threads[].id')
for tid in $THREADS; do
gog gmail thread modify $tid --account=maroffo@gmail.com --remove-labels=INBOX
done
Process in batches of 50. Report progress.
Quick Stats
gog gmail labels get INBOX --account=maroffo@gmail.com
gog gmail labels get CATEGORY_PROMOTIONS --account=maroffo@gmail.com
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/maroffo/claude-forge/email-cleanup">View email-cleanup on skillZs</a>