email-triage-system

Filter Gmail noise with pattern matching and summarize important emails via LLM.

2|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/ShaggyD/agent-toolkit --skill email-triage-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: email-triage-system
Source: https://github.com/ShaggyD/agent-toolkit/tree/main/tools/email-triage
Command: npx skills add https://github.com/ShaggyD/agent-toolkit --skill email-triage-system

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-api-python-client, google-auth-httplib2, google-auth-oauthlib, pyyaml, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This system solves the problem of inbox clutter by separating high-volume noise from critical communications, preventing the cognitive load of manual triage and reducing LLM token costs.

Core Features & Use Cases

  • Zero-LLM Janitor: Automatically archives promotions, newsletters, and social notifications using pattern matching and the Gmail API.
  • LLM-Powered Reviewer: Surfaces only the remaining important emails in a daily, actionable summary brief.
  • Use Case: A developer can use this to automatically archive all GitHub notifications and marketing emails while ensuring that security alerts and direct client messages are surfaced in a daily morning digest.

Quick Start

Run the janitor script with the dry-run flag to preview which emails will be archived based on your current configuration.

Frequently Asked Questions about email-triage-system

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

FAQPage Schema
How do I automate Gmail inbox triage to achieve inbox zero?

Automate Gmail inbox triage by using pattern matching to archive bulk noise like promotions and social notifications, then applying LLM reasoning to summarize remaining important emails into a daily actionable brief.

Can I filter promotional emails in Gmail without using LLM tokens?

Yes, you can filter promotional emails without LLM tokens by using the Zero-LLM Janitor script, which relies on pattern matching and the Gmail API to automatically archive newsletters and marketing noise.

What is the best way to surface critical security alerts from Gmail noise?

The best way to surface critical alerts is to separate noise from signal using automated pattern matching, allowing LLM reasoning to review only the remaining direct messages and security alerts in a daily digest.

Do I need a cron job to maintain automated Gmail archiving?

Yes, you need a configured cron job for periodic execution of the automated Gmail archiving scripts, ensuring the inbox is continuously maintained without manual intervention.

Does Gmail inbox automation work with Python and API credentials?

Yes, Gmail inbox automation works with Python 3.10+ and requires Gmail API credentials configured through the google-api-python-client and google-auth-oauthlib libraries to access your account.

How do I preview which emails will be archived before running the filter?

Preview which emails will be archived by running the janitor script with the dry-run flag, allowing you to safely test your pattern matching configuration against your current inbox.