skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
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-cleanup
view source ↗

Is 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

  1. NEVER delete without confirmation - show counts first
  2. Archive over delete - prefer archiving (recoverable)
  3. Batch in chunks - max 50 at a time

Cleanup Targets

CategoryQueryAction
Promotionscategory:promotions older_than:30dArchive
Socialcategory:social older_than:14dArchive
Read updatescategory:updates is:read older_than:7dArchive
Large emailslarger:10MReview individually
Unsubscribe candidatesunsubscribe is:read older_than:30dReview

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

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>