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.