# Send Gmail Inbox Zero Traige to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "gmail-inbox-zero-triage",
    "name": "Gmail Inbox Zero Traige",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage",
    "canonicalUrl": "https://clawhub.ai/poisondminds/gmail-inbox-zero-triage",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/gmail-inbox-zero-triage",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=gmail-inbox-zero-triage",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "CLAWHUB-SUBMISSION.md",
      "OVERVIEW.md",
      "README.md",
      "SETUP.md",
      "SHARE.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/gmail-inbox-zero-triage"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage",
    "downloadUrl": "https://openagent3.xyz/downloads/gmail-inbox-zero-triage",
    "agentUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent",
    "manifestUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.md"
  }
}
```
## Documentation

### Gmail Inbox Zero Triage

Achieve inbox zero with AI-powered email triage! Process ALL Gmail inbox messages interactively with summaries and batch actions using OAuth (no passwords needed).

### Features

✅ OAuth-based - No passwords, secure authentication via gog
✅ AI summaries - Quick 1-line summary of each email
✅ Batch processing - Queue actions instantly, execute at the end
✅ Telegram buttons - Archive, Filter, Unsubscribe, View
✅ Inbox zero focus - Process ALL inbox messages (read + unread)
✅ Fast workflow - No waiting between actions

### Workflow

User triggers: "Triage my emails" or "Process my inbox"
Fetch ALL inbox messages from Gmail (up to 20 at a time)
Display all emails at once with:

Subject and sender
AI-generated summary (1 line)
Telegram inline buttons for actions


User clicks actions for each email (queued instantly, no API calls yet)
User clicks "Done" button to execute all queued actions in batch
Repeat until inbox zero! 🎯

### Prerequisites

Requires: gog CLI with authenticated Gmail account.

Check if already set up:

gog auth list

If not set up, user needs to run gog auth add (see gog skill for OAuth setup).

Set environment variable for keyring password:

export GOG_KEYRING_PASSWORD="your-password"

### Telegram Button Layout

Each email displays with 4 action buttons:

[📥 Archive] [🔍 Filter]
[🚫 Unsub]   [📧 View]

📥 Archive - Remove from inbox, mark as read
🔍 Filter - Create filter to auto-archive future emails from sender
🚫 Unsubscribe - Find and open unsubscribe link
📧 View - Show full email content
No click = Skip (leave in inbox)

At the end:

[✅ Done - Execute All Actions]

### Action Queue System

Actions are queued using short callback codes to avoid Telegram's 64-char limit:

q:a:0 = queue archive, message index 0
q:f:0 = queue filter, message index 0
q:u:0 = queue unsubscribe, message index 0
q:v:0 = view full email, message index 0 (executes immediately)
q:done = execute all queued actions

Queue is managed via scripts/queue_manager.py and stored in action_queue.json.

### gog_processor.py

Main processor for Gmail operations via gog CLI.

List inbox messages:

python3 scripts/gog_processor.py list <account> [limit]

Archive a message:

python3 scripts/gog_processor.py archive <account> <msg_id>

Find unsubscribe link:

python3 scripts/gog_processor.py unsubscribe <account> <msg_id>

Create filter:

python3 scripts/gog_processor.py filter <account> "<from_header>"

Get message body:

python3 scripts/gog_processor.py body <account> <msg_id>

### queue_manager.py

Manages action queue for batch execution.

Add action to queue:

python3 scripts/queue_manager.py add <action> <msg_id> [from_header]

Get queue:

python3 scripts/queue_manager.py get

Clear queue:

python3 scripts/queue_manager.py clear

### execute_queue.py

Executes all queued actions in batch.

python3 scripts/execute_queue.py <account>

Returns JSON with results of all executed actions.

### Implementation Steps

Load current batch: Fetch inbox messages and save to current_batch.json
Display all emails: Show each with summary and buttons
Handle button callbacks:

Archive/Filter/Unsub: Add to queue via queue_manager.py
View: Fetch and display full email immediately
Done: Execute queue via execute_queue.py


Show results: Report archived count and remaining inbox count
Repeat if needed: Fetch next batch or celebrate inbox zero

### AI Summary Guidelines

Generate concise 1-line summaries:

Receipts/Invoices: "Payment receipt for $X. Financial record."
Security alerts: "Security notification about [action]. [Important/Standard] alert."
Newsletters: "Newsletter about [topic]. No action required."
Calendar: "Calendar [event type] for [date/time]."
Legal: "Legal [document type]. [Brief context]."

Keep it simple, factual, and action-oriented.

### Security Notes

OAuth-based authentication - No passwords needed, uses gog's OAuth tokens
Tokens stored securely by gog CLI in system keychain
Read/modify permissions - gog only gets access to what user grants
Queue stored locally - Action queue is temporary, cleared after execution

### Error Handling

Common issues:

gog not authenticated: Run gog auth add <account>
Account not found: Check gog auth list for available accounts
No inbox messages: Success state - inbox zero achieved!
Permission denied: User may need to re-authenticate with gog
Keyring password: Set GOG_KEYRING_PASSWORD environment variable

### Dependencies

gog CLI - Must be installed and authenticated (see gog skill)
Python 3 - Standard library only (subprocess, json, re, pathlib)

No additional pip packages needed.

### Tips for Best Experience

Process regularly: Triage inbox daily to maintain inbox zero
Use filters liberally: Auto-archive recurring newsletters and notifications
Archive aggressively: If you don't need it now, archive it (searchable in All Mail)
Batch mode is fast: Process 10-20 emails in under a minute
Trust the summaries: AI summaries are accurate for quick decisions
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: poisondminds
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/gmail-inbox-zero-triage)
- [Send to Agent page](https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent)
- [JSON manifest](https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/gmail-inbox-zero-triage/agent.md)
- [Download page](https://openagent3.xyz/downloads/gmail-inbox-zero-triage)