跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
营销与销售

gmail-triage

Triage your Gmail inbox using the Google Workspace CLI (gws). Use this skill whenever the user asks to: check email, triage inbox, scan for important messages, summarize newsletters, do a morning email check, or anything involving reading and categorizing unread emails. Also trigger when the user says things like "what's in my inbox", "any important emails", "check my email", "email briefing", "newsletter recap", or "mark emails as read". This skill is READ-ONLY — it never sends, replies to, or forwards emails.

reymerekar7 · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add reymerekar7/rm-skills --skill gmail-triage

技能说明


name: gmail-triage description: > Triage your Gmail inbox using the Google Workspace CLI (gws). Use this skill whenever the user asks to: check email, triage inbox, scan for important messages, summarize newsletters, do a morning email check, or anything involving reading and categorizing unread emails. Also trigger when the user says things like "what's in my inbox", "any important emails", "check my email", "email briefing", "newsletter recap", or "mark emails as read". This skill is READ-ONLY — it never sends, replies to, or forwards emails.

Gmail Triage Skill

You help the user stay on top of their inbox without getting sucked into it. Your job is to surface what matters, summarize what's informational, and clean up the noise — all without ever sending a single email.

Philosophy

Email is a todo list other people write for you. The goal is to protect attention:

  1. Flag what's important — anything requiring a decision, response, or action
  2. Summarize what's informational — newsletters grouped by topic so you get the value without the time sink
  3. Clean up the rest — mark low-priority emails as read so they stop cluttering the unread count

This skill is strictly read-only. Never send, reply, forward, or draft emails. If something needs a response, surface it — don't do it.


Prerequisites

The Google Workspace CLI must be installed and authenticated:

npm install -g @googleworkspace/cli
gws auth setup

Verify it works: gws gmail +triage should return unread inbox data.


Scope

Primary inbox only. Only triage emails in category:primary. Ignore promotions, social, updates, and forums unless explicitly asked to check those.


Helper Scripts

Reusable scripts live in <skill-directory>/scripts/:

  • extract_newsletter.py — Extracts readable text from raw gws message JSON (base64-decoded). Pipe from gws or stdin:

    gws gmail users messages get --params '{"userId":"me","id":"MSG_ID","format":"full"}' \
      | python <skill-directory>/scripts/extract_newsletter.py
    
  • mark_read.sh — Marks one or more messages as read. Run sequentially (not backgrounded) to avoid race conditions:

    bash <skill-directory>/scripts/mark_read.sh MSG_ID1 MSG_ID2 MSG_ID3
    

Triage Workflow

Step 1: Pull the primary inbox

Start with the triage helper:

gws gmail +triage

This returns sender, subject, and date for unread messages. Filter to primary only — skip anything in promotions, social, updates, or forums categories (check labelIds).

For more detail on specific messages (e.g., to read a newsletter body), fetch individually:

gws gmail users messages get --params '{"userId":"me","id":"<message_id>","format":"full"}'

Then pipe through the extract script to get readable text:

gws gmail users messages get --params '{"userId":"me","id":"<message_id>","format":"full"}' \
  | python <skill-directory>/scripts/extract_newsletter.py

Other useful queries:

gws gmail users messages list --params '{"userId":"me","maxResults":20,"q":"is:unread category:primary"}'

Step 2: Categorize every email

Go through each unread message and assign it to one of three buckets:

Action Required — Flag these and keep unread. Characteristics:

  • From a real person the user knows or works with (clients, collaborators, friends, family)
  • Mentions money, deals, contracts, deadlines, or meetings
  • Asks a direct question or requests a decision
  • Time-sensitive (event RSVPs, expiring offers relevant to business)
  • From platforms where the user has active business
  • From any sender the user has told you to always flag

Newsletter / Informational — Summarize these, then mark as read. Characteristics:

  • AI/tech newsletters (TLDR, Ben's Bites, The Neuron, Import AI, Superhuman, etc.)
  • Industry updates, product launches, funding news
  • Business/creator economy newsletters
  • Fitness, health, mindset, or personal development content
  • Marketing or growth content

Low Priority — Mark as read silently. Characteristics:

  • Automated notifications (GitHub, Notion, app alerts)
  • Marketing/promotional emails from brands
  • Social media notifications (LinkedIn, X, Instagram)
  • Receipts and order confirmations (unless very recent / relevant)
  • Spam or irrelevant outreach

When in doubt, err on the side of flagging as important — better to surface something irrelevant than miss something that mattered.

Step 3: Summarize newsletters by topic

For Newsletter emails, always fetch the full body before summarizing — never summarize from subject line alone. Pipe through the extract script to get readable text, then group summaries by broad topic:

  • AI / Tech — lead with this group, give it the most depth. Focus on what's relevant: AI agents, developer tools, new models, content creation tech, solo founder tools
  • Business / Creator Economy — growth strategies, monetization, newsletter tactics, sponsorship trends
  • Fitness / Health — training science, nutrition, recovery
  • Mindset / Personal Development — productivity, mental models, habits
  • Other — anything that doesn't fit the above

For each newsletter:

  • 3-5 bullet points — focus on what's actionable or relevant, not just what it covered
  • Call out anything that's a potential content idea or business opportunity
  • Include any specific numbers, studies, or tools mentioned — concrete details beat vague summaries
  • Skip the fluff entirely

Step 4: Mark all emails as read

After delivering the briefing, mark every email as read — including Action Required ones. The briefing itself is the user's signal to handle what matters; the inbox should be clean afterward.

bash <skill-directory>/scripts/mark_read.sh MSG_ID1 MSG_ID2 MSG_ID3 ...

Or individually:

gws gmail users messages modify --params '{"userId":"me","id":"<message_id>"}' --json '{"removeLabelIds"
阅读完整来源 ↗