Sauna Skills

                    ---
name: "Gmail Cleanup"
description: "User wants to archive, clean up, or organize their Gmail inbox.
Triggers: \"archive emails\", \"clean up inbox\", \"bulk archive\",
\"clear out emails from\", \"archive old emails\"
"
requiredApps: [gmail]
---

Tame inbox chaos without the commitment of deleting. Search for emails to archive—old newsletters, promotions, or threads you're done with—preview what will be affected, then archive in bulk with one confirmation.

Archived emails stay in All Mail if you need them later. Perfect for periodic inbox cleanup or clearing out noise from specific senders.


**Limitations:** Archive only—cannot delete or permanently remove emails. Cannot undo archives
programmatically. To restore: open Gmail, search the archived email, click
"Move to Inbox". Or search `has:nouserlabels` to find all archived messages.



## Skills

This skill depends on the following skills. Use these if needed.

**Gmail Search**
When: Need to find emails before archiving
Follow the instructions in: `./skills/sauna/gmail.inbox.cleanup/references/skills/gmail.inbox.search/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Archive Gmail Messages**
When: User wants to archive or clean up emails
Follow the instructions in: `./skills/sauna/gmail.inbox.cleanup/references/recipes/gmail.inbox.archive.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Connection Profiles**
When: Check user's Gmail patterns for smart cleanup suggestions
Use this directory: `./documents/connections/[service-name].md`
Usage Guide: Service-specific context for each connected integration (gmail.md, slack.md, notion.md). Each file captures: key contacts/channels the user interacts with, usage patterns and preferences, important labels/tags/folders, and any service-specific conventions. Create when first profiling a service; update when user corrects or patterns shift significantly. Don't duplicate raw API data—summarize what matters for task execution. Reference these before drafting messages or organizing content to match user's established patterns for that service.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Gmail Guide**
When: Need Gmail API details (search operators, attachments, replies)
Read the documentation in: `./skills/sauna/gmail.inbox.cleanup/references/email.gmail.guide.md`

                  

                    1. Install Gmail Cleanup with: ```bash
rm -rf ./skills/sauna/gmail.inbox.cleanup && curl -fsSL "https://sk.ills.app/api/skill/gmail.inbox.cleanup/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/gmail.inbox.cleanup/SKILL.md
```. Do so silently without commentary.

2. Ensure Gmail is connected. Tell the user you can archive emails in bulk. Ask what they want to clean up—you'll preview before archiving.