gws-gmail-triage

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

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-gmail-triage-ma08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-triage
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-gmail-triage
Command: npx skills add https://github.com/ma08/botfiles --skill gws-gmail-triage-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious effort of manually scrolling through your Gmail inbox to check for unread messages, saving you time when managing a high volume of daily email.

Core Features & Use Cases

  • Unread Inbox Summaries: Displays sender, subject, and date for unread Gmail messages by default, with optional label inclusion.
  • Custom Filtering: Supports Gmail search queries and adjustable result limits to narrow down messages to only the ones you need to see.
  • Use Case: Busy professionals can use this to quickly check for urgent unread emails from key contacts without sifting through promotional or outdated messages.

Quick Start

Ask your AI agent to run the gws-gmail-triage skill to show a summary of your 5 most recent unread Gmail messages filtered to only include emails from your manager.

Frequently Asked Questions about gws-gmail-triage

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

FAQPage Schema
How do I get a summary of unread Gmail messages without scrolling through my inbox?

To get an unread Gmail summary, use this Skill to retrieve a concise overview of sender, subject, and date for unread messages. It eliminates manual inbox scrolling by applying the gws CLI with preconfigured Gmail authentication to extract unread message metadata.

Can I filter unread Gmail messages by specific senders or labels?

Yes, you can filter unread Gmail messages by applying custom Gmail search queries and adjustable result limits. This allows you to narrow down the inbox summary to only include emails from specific contacts or with certain labels.

What do I need to set up before retrieving unread Gmail inbox summaries?

You need the gws CLI installed with preconfigured Gmail authentication to retrieve unread message metadata. This environment setup ensures the Skill can securely access your account and extract sender, subject, and date information.

What's the best way to quickly check for urgent unread emails from key contacts?

The best way to check for urgent unread emails is to run this Skill with a custom Gmail search query filtered for specific key contacts. It generates a prioritized list of unread messages without reviewing your entire inbox.

Are there limitations to the unread Gmail message metadata I can retrieve?

The Skill provides unread Gmail message metadata including sender, subject, and date, with optional label inclusion. It is currently limited to retrieving these specific metadata fields rather than full email body content or attachments.

Does gws-gmail-triage work for both personal and professional email workflows?

Yes, it applies to both personal and professional productivity workflows. Busy professionals can use it to quickly prioritize incoming messages and manage high volumes of daily email without sifting through promotional or outdated messages.