gmail-triage

gmail-triage is a skill for Claude Code from metraton/gaia. It costs 24 tokens per session (2,652 once invoked), scanned A, original, MIT.

An interactive process for sorting Gmail conversations into states such as needing action, awaiting a reply, someday, pending review, or soft-deleted. GTD means “Getting Things Done,” a method for organizing tasks and follow-ups.

In plain words
What is it for?
Use it to review threads, identify who last replied, label conversations, find follow-ups, and manage pending or soft-deleted mail.
Why use it?
It prevents inbox cleanup from becoming an unstructured list of messages and keeps decisions under the user's control, including before potentially risky actions.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the gaia plugin — 38 skills, 9 agents, 11 hooks shipped together

Good fit Use it to review threads, identify who last replied, label conversations, find follow-ups, and manage pending or soft-deleted mail.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/metraton/gaia/gmail-triage
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add metraton/gaia --skill gmail-triage
Clone the repo
git clone --depth 1 https://github.com/metraton/gaia

Made for: Claude Code.

Or install gaia, the plugin that ships this one along with the rest of its 38 skills, 9 agents, 11 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gmail-triage

README.md
[![agentmods](https://agentmods.dev/badge/skills/metraton/gaia/gmail-triage/github.svg)](https://agentmods.dev/skills/metraton/gaia/gmail-triage)
Your own site
<a href="https://agentmods.dev/skills/metraton/gaia/gmail-triage"><img src="https://agentmods.dev/badge/skills/metraton/gaia/gmail-triage/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for gmail-triage

Your own site · 80×15
<a href="https://agentmods.dev/skills/metraton/gaia/gmail-triage"><img src="https://agentmods.dev/badge/skills/metraton/gaia/gmail-triage.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 24 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,652 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.02652
Opus 5 $0.00012 $0.01326
Sonnet 5 $0.00005 $0.00530
Haiku 4.5 $0.00002 $0.00265

Measured 9d ago against content hash cfc9b88a06a6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

gmail-triage scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/gmail-triage/SKILL.md · 145 lines

How it starts

The opening of the file, as written. The whole thing — 145 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Gmail Triage

Interactive GTD-inspired state machine for Gmail. Gaia analyzes threads, proposes transitions. User decides. Gaia executes. This is the PROCESS layer; it depends on gmail-policy for every rule -- label definitions, security tiers, the interpretation of a review trigger (Intent Classification), and the Autonomous Action Boundary that decides what may run without approval. That dependency holds in every mode, headless included: a security rule cannot live only in the process that obeys it.

State Labels

Five _gaia/* labels (defined in gmail-policy) — three durable active states, plus staging and soft-delete:

  • _gaia/action — user must act
  • _gaia/waiting — user acted, awaiting reply
  • _gaia/someday — interesting, no urgency
  • _gaia/pending — staging (triage backlog)
  • _gaia/trash — soft delete; never truly deleted

No _gaia/* label = processed/done.

Thread-Awareness Rule

Before presenting ANY labeled email, check the thread: message count, who sent last, when. This determines framing:

  • "necesitas responder" (user is last)
  • "esperando desde [date]" (user replied, waiting on them)
  • "sin actividad hace 2 semanas — ¿hacer seguimiento?" (stale waiting)

These two sections are the state-machine expression of the Autonomous Action Boundary in gmail-policy — the boundary is the rule, these are its transitions.

Automatic Transitions (no confirmation needed)

  • User replies to an action thread → move to waiting
  • New message arrives in a waiting thread → move to action

Transitions Requiring Confirmation

  • Anything → trash or someday
  • Clearing any label (marking done)
  • somedayaction

Modes

Modes 1–5 open with a state summary before their specific work: "Antes de empezar: N en action, N en waiting, N en someday." Flag action items stale >3 days.

0. Check ("chequea mi mail" / "¿algo nuevo?")

  1. Review _gaia/action — present each item with thread framing. Did user already reply? Auto-apply → waiting (mechanical, reversible — no confirmation).
  2. Review _gaia/waiting — did the other party respond? Auto-apply → action (mechanical, reversible — no confirmation). Stale >1 week → flag.
  3. Review _gaia/someday — count only: "tienes 5 en someday." Detail only if asked.
  4. Scan inbox for new signal — Financial (large amounts, bills, due dates), personal/important (housing, legal, health), expected reply arrived → propose action. Interesting, no urgency → propose someday.
  5. Summarize — overall inbox state in 2-3 sentences.

Read the full file on GitHub · 145 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 145 lines · 24 tokens per session scan A cfc9b88a06a6

Subscribe to this mod's changes

gmail-triage is a skill published in the GitHub repository metraton/gaia (3 stars, last pushed today), licensed MIT. It adds 24 tokens to every session and 2,652 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories