Skip to main content
Generalopenai

gmail-inbox-triage

Triage a Gmail inbox into actionable buckets such as urgent, needs reply soon, waiting, and FYI using connected Gmail data. Use when the user asks to triage the inbox, rank what needs attention, find what still needs a reply, or separate important mail from noise.

Stars
1,305
Source
openai/plugins
Updated
2026-05-30
Slug
openai--plugins--gmail-inbox-triage
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/openai/plugins/HEAD/plugins/gmail/skills/gmail-inbox-triage/SKILL.md -o .claude/skills/gmail-inbox-triage.md

Drops the SKILL.md into .claude/skills/gmail-inbox-triage.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

Gmail Inbox Triage

Overview

Use this skill for direct inbox-triage requests. Build on the core Gmail skill at ../gmail/SKILL.md, especially its search and thread-reading guidance.

Workflow

  1. Default to INBOX and a clear timeframe unless the user asks for a broader audit.
  2. Use search_emails to build a shortlist before reading bodies.
  3. Exclude obvious noise early if newsletters, calendar churn, or automated alerts dominate the first pass.
  4. Use batch_read_email only when snippets are not enough to classify urgency or reply-needed status.
  5. Escalate to read_email_thread when a message appears to be part of an active conversation and the surrounding thread may change the classification. Be careful because low-signal notifications can turn into long threads; read_email_thread exposes total_messages, which helps detect that.
  6. Return the result in explicit Inbox Zero-style buckets such as Urgent, Needs reply soon, Waiting, and FYI.

Bucket Heuristics

  • Urgent: direct asks with time pressure, blocking messages, decision requests with deadlines, or operational mail that can break if ignored.
  • Needs reply soon: direct asks without same-day urgency, active conversations where the user is the next responder, or follow-ups that will go stale if ignored.
  • Waiting: threads where the user already replied or the current blocker belongs to someone else.
  • FYI: announcements, newsletters, calendar churn, and transactional mail that does not require action.

Output

  • Include sender, subject, why each item is in its bucket, and the likely next action.
  • State timeframe, search scope, and confidence.
  • Treat reply-needed as an inference, not a guaranteed state.
  • Avoid claiming the inbox is fully triaged if you only checked a narrow slice.