skills.rest
cdrguru
cdrguruCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gws-gmail-triage

Display unread Gmail messages with sender, subject, and date via CLI flags.

1|Updated Dec 21, 2025
Search Tags:#automation#cli#inbox#gmail#summary#triage#unread
One-click install
npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-gmail-triage-cdrguru
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/cdrguru/portable-agent-kit/tree/main/.agent/skills/gws-gmail-triage
Command: npx skills add https://github.com/cdrguru/portable-agent-kit --skill gws-gmail-triage-cdrguru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Scanning an inbox to identify unread messages is time-consuming; this skill provides a concise summary of unread Gmail messages including sender, subject, and date to speed triage.

Core Features & Use Cases

  • Show unread messages with sender, subject, and date for quick assessment.
  • Optional max limit and query filtering to tailor results to your needs.
  • Include labels for additional context when desired.

Quick Start

Run the gws Gmail +triage command to display unread messages for your account.

Frequently Asked Questions about gws-gmail-triage

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

FAQPage Schema
How do I view unread Gmail messages quickly from the command line?▼

Filter unread Gmail messages using CLI flags like --query and --labels to tailor results to your needs. You can apply custom queries and include label context to narrow down the displayed unread items.

Can I limit the number of unread Gmail messages shown in the summary?▼

Limit the number of unread Gmail messages displayed by using the --max CLI flag. This restricts the output volume, which is useful for rapid triage across high-volume accounts.

Does the Gmail triage tool modify my inbox or mark messages as read?▼

The Gmail triage tool never modifies your mailbox or marks messages as read. It only reads authentication context to display a read-only summary of unread messages for safe inbox assessment.

What do I need to set up before scanning unread Gmail messages with this tool?▼

You need to have authentication context set up via gws-shared before scanning unread Gmail messages. The tool reads this authentication context to securely access your account and display unread items.

What's the best way to triage a high-volume Gmail inbox without opening a browser?▼

The best way to triage a high-volume Gmail inbox without a browser is using a CLI triage tool that summarizes unread messages. It supports query filtering and max limits to quickly assess senders and subjects.

Related Skills

Explore More Content & Communication Skills→
vikingokftvikingokft

gws-gmail

Automate Gmail send, read, and message management via gws CLI and Gmail API.

Official
Intermediate
cosmicdreamscosmicdreams

personal-email

Manage personal Gmail by listing unread messages, fetching contents, and sending replies.

Community
Intermediate
ma08ma08
28

gws-gmail-triage

Displays unread Gmail message metadata (sender, subject, date) from the gws CLI.

Community
Basic
niclasmartinsson-sysniclasmartinsson-sys
8

gws-gmail-triage

Fetch unread Gmail messages and summarize sender, subject, and date.

Community
Intermediate