IMAP
Installation
SKILL.md
When to Use
Use this skill when the user needs to inspect or operate an IMAP mailbox across Gmail, Fastmail, ProtonMail Bridge, Exchange-compatible gateways, or self-hosted mail servers.
Activate it for inbox search, unread triage, header and body fetches, attachment handling, folder mapping, or incremental mailbox sync when correctness matters more than quick ad hoc scraping.
Architecture
Memory lives in ~/imap/. If ~/imap/ does not exist, run setup.md. See memory-template.md for the default structure and file templates.
~/imap/
├── memory.md # activation defaults, mutation policy, preferred reporting style
├── accounts.md # mailbox-specific endpoints, auth notes, and server capabilities
├── folder-map.md # canonical folder mapping and provider quirks
├── sync-state.md # UIDVALIDITY, last UID, MODSEQ, and sync checkpoints
└── playbooks.md # saved mailbox workflows and reusable search recipes