gmail-triage

Analyze Gmail threads and apply user-approved label transitions.

3|1|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/metraton/gaia --skill gmail-triage-metraton
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gmail-triage
Source: https://github.com/metraton/gaia/tree/main/skills/gmail-triage
Command: npx skills add https://github.com/metraton/gaia --skill gmail-triage-metraton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gmail inbox management is time-consuming and error-prone when handling threads, labels, and actions across large volumes. This Skill provides an interactive, state-driven approach to triage messages by analyzing threads, proposing transitions between labels (_gaia/action, _gaia/waiting, _gaia/someday, _gaia/pending), and executing user-approved changes.

Core Features & Use Cases

  • Workflow-driven inbox triage: analyze threads, propose transitions between _gaia/action, _gaia/waiting, _gaia/someday, and _gaia/pending labels, and apply user-approved actions.
  • Policy-governed operations: uses the gmail-policy rules to ensure safe label changes and consent before destructive actions.
  • Use Case: rapidly clean up a crowded inbox by batching decisions and executing them with user confirmation.

Quick Start

Review my Gmail threads, propose label transitions, and apply user-approved changes to organize my inbox.

Frequently Asked Questions about gmail-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Gmail triage for a crowded inbox?▼

Gmail triage automation analyzes your inbox threads and proposes label transitions to states like _gaia/action or _gaia/waiting. It batches decisions and executes only your user-approved changes to organize messages efficiently.

How does label-based inbox cleanup work for managing email workflows?▼

Label-based inbox cleanup works by analyzing email threads and proposing transitions between status labels such as _gaia/pending, _gaia/someday, and _gaia/action. This state-driven approach tracks urgency and work status before executing approved actions.

Can I batch organize Gmail threads without risking unintended email deletions?▼

Yes, you can batch organize Gmail threads safely. The triage process enforces safety constraints via gmail-policy rules, preventing unsafe changes and ensuring every label transition requires explicit user consent before execution.

What is the best way to track waiting emails in a Gmail workflow?▼

The best way to track waiting emails is using a state-driven triage workflow that proposes label transitions to _gaia/waiting. This categorizes threads by urgency and work status, keeping your inbox organized and actionable.

Does Gmail triage require manual confirmation for every label change?▼

Gmail triage requires manual confirmation for label changes to ensure safety. It proposes transitions across states like _gaia/action and _gaia/pending, but only executes actions after receiving explicit user approval.