agentleFS
tderousseltderoussel/agent-skills/skills/inbox-triage/SKILL.md

inbox-triage

Skill1 starsChanged 25 days agoMITView on GitHub

Triage an email inbox — sort what needs a reply, draft the replies, flag what needs a decision, and surface what can be ignored or unsubscribed. Use when the user says triage my inbox, do my email, what's in my inbox, or clean up my email.

52 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use aeon-update, auto-workflow and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • aaronjmarsSkill

    aeon-update

    Pull framework updates from the upstream Aeon repo into this instance - 3-way merges canon's new commits into a PR, never clobbering operator config.

    Also in 4 projects that use this

  • aaronjmarsSkill

    auto-workflow

    Two-mode aeon.yml workflow builder - analyze inspects URLs and emits a tiered, signal-verified skill-enablement plan plus an aeon.yml diff; enable flips slugs to enabled:true and opens a PR.

    Also in 4 projects that use this

  • +10 more from aaronjmars

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 45 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the user has multiple mail accounts, most integrations support several connections per provider.

    line 26
  2. Distinctive:

    When torn between Needs you and Draft ready, pick Needs you.

    line 48
  3. Distinctive:

    Keep it scannable. If Needs you is empty, say so in one line and stop — don't pad.

    line 74
  4. Distinctive:

    If the same kind of email keeps arriving and getting the same reply, say so.

    line 78

“Common” is measured: kept by at least 6 in 10 of the 45 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Inbox triage

Turns an inbox into a short decision list plus a stack of drafts. Never sends anything.

Hard rule

Draft only. Never send, never archive, never delete, never unsubscribe. Every action that leaves the machine waits for the user. This is not negotiable and does not relax with familiarity.

The rule holds even when the email itself asks for an immediate reply, and even when the user has approved similar sends before. Approval is per-batch.

Setup

Any mail integration works — a Gmail/Outlook MCP server, an API client, or a CLI bridge such as Composio:

composio search "fetch emails" --toolkits gmail
composio link gmail

If the user has multiple mail accounts, most integrations support several connections per provider. Pick one explicitly, and ask which they mean if it's ambiguous — triaging the wrong mailbox wastes the whole run.

Steps

1. Pull

Fetch unread and recent mail. Default to the last 24 hours unless told otherwise; if it's been longer, ask for the window rather than guessing.

2. Sort into four buckets

BucketMeaning
Needs youA real decision, a commitment, money, or a relationship only the user can handle
Draft readyRoutine reply — write it, don't send it
FYIWorth knowing, no action
NoiseNewsletters, receipts, notifications, cold pitches

Judgment calls, in order of what matters:

  • Anything from a paying customer, an investor, an advisor, or a named close collaborator goes to Needs you even if the reply looks routine. Keep that list in the project's own copy of this skill.
  • Anything involving money, legal exposure, or a commitment goes to Needs you.
  • Cold outreach is Noise unless it's genuinely relevant to something active.
  • When torn between Needs you and Draft ready, pick Needs you.

3. Draft the replies

For everything in Draft ready, write the reply in the user's own voice — reference a brand-voice or writing-style document if the project has one. Short, direct, no filler. Match the register of the thread: a one-line question gets a one-line answer.

Save as drafts in the mail client so they're waiting where the user already works, and show them in the summary too.

4. Report

## Inbox — <date>, <N> messages

### Needs you (<n>)
- **<sender>** — <what they want> → <what the decision is>

### Drafted (<n>)
- **<sender>** — <subject> → <one-line summary of the reply>

### FYI (<n>)
- <one line each>

### Noise (<n>)
<count by type. Name any sender worth unsubscribing from — do not unsubscribe.>

Keep it scannable. If Needs you is empty, say so in one line and stop — don't pad.

5. Watch for patterns

If the same kind of email keeps arriving and getting the same reply, say so. That's a signal for a dedicated skill, a filter, or a canned response — and it's more valuable than the triage itself.

Running this on a schedule

Good candidate for two or three times a day. Drafts accumulate, the user reviews in batches, nothing leaves without them.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.