email-cleanup

Archive old Gmail emails and delete promotions using gog CLI and Bash.

16|2|Updated Nov 9, 2025
One-click install
npx skills add https://github.com/maroffo/claude-forge --skill email-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email-cleanup
Source: https://github.com/maroffo/claude-forge/tree/main/skills/email-cleanup
Command: npx skills add https://github.com/maroffo/claude-forge --skill email-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps users manage their Gmail inbox by automatically archiving old emails, deleting promotional content, and freeing up storage space.

Core Features & Use Cases

  • Automated Archiving: Archives emails based on categories like Promotions and Social older than a specified duration.
  • Storage Management: Identifies large emails and potential unsubscribe candidates for review.
  • Use Case: If your inbox is cluttered with old promotions and social notifications, this skill can automatically archive them, making it easier to find important messages and reclaim storage.

Quick Start

Use the email-cleanup skill to archive all promotions older than 30 days.

Frequently Asked Questions about email-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically archive old Gmail promotions to free up storage?

To archive Gmail promotions and free up storage, you can use a scripted cleanup process that targets messages older than a specified duration, such as 30 days, and moves them out of the primary inbox. This skill automates that exact archiving workflow.

What is the best way to clean up Gmail storage by deleting promotional emails?

Cleaning up Gmail storage by deleting promotional emails involves identifying large messages and category-specific clutter, then executing bulk removal scripts. This skill identifies those large emails and potential unsubscribe candidates for review to reclaim digital space.

Do I need the gog CLI tool to manage my Gmail inbox cleanup?

Yes, you need the gog CLI tool to interact with Gmail, alongside Bash for scripting the operations. These dependencies are required to execute the automated archiving and storage management tasks within your inbox.

Can I identify large emails and unsubscribe candidates in Gmail automatically?

Yes, you can identify large emails and potential unsubscribe candidates automatically. This skill provides storage management features that scan your inbox to flag bulky messages and recurring promotional senders for your review.

Does Gmail cleanup work for both social notifications and promotional categories?

Yes, Gmail cleanup works for both Social and Promotions categories. The automated archiving feature targets messages across these specific categories once they surpass your specified age threshold to declutter the inbox.

Why should I archive old emails instead of deleting them to manage Gmail storage?

Archiving old emails rather than deleting them manages Gmail storage by removing clutter from the primary view while retaining the data securely. This approach makes important messages easier to find without permanently losing historical correspondence.