email-triage_skill

This skill generates a scheduled email digest by triaging recent messages into three categories, notifying via Telegram and delivering a podcast voice brief.

TypeScript

14

GitHub Stars

1

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill terrylica/cc-skills --skill email-triage

SKILL.md2.4 KB

Overview

This skill automates scheduled email triage and delivers a concise digest every 6 hours. It classifies messages into three categories (System & Security, Work, Personal & Family), ranks urgency, and pushes key items to Telegram plus an optional podcast-style voice briefing. The goal is to reduce inbox noise and surface only actionable alerts.

How this skill works

The skill fetches recent emails using a local Gmail CLI, runs triage prompts through the Haiku Agent SDK to assign category and urgency, then composes a short digest. Significant items are sent as Telegram messages and rendered as a short podcast voice briefing. A launchd schedule runs the digest every 6 hours, and manual invocation is supported via a CLI script.

When to use it

Automate regular inbox monitoring for busy professionals
Catch security and system alerts promptly (2FA, password resets, device logins)
Keep track of work-related items like deadlines, invoices, and PRs
Remain aware of personal and family messages without inbox context switching
Generate a quick audio briefing for commuting or hands-free review

Best practices

Complete mandatory preflight checks: digest script, env vars, and Gmail CLI binary must be present
Store credentials in environment variables (GMAIL_OP_UUID, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, HAIKU_MODEL) and confirm they are SET before running
Use $HOME-based path patterns to keep scripts portable across machines
Tune category and urgency prompts in the referenced configuration to match your workflow
Run the manual digest command for testing before enabling launchd schedule

Example use cases

Daily operations team: surface critical system alerts and PRs to on-call staff via Telegram
Freelancer: triage invoices and contracts into a focused work digest
Parent: receive appointment and family updates summarized as low-noise notifications
Security-conscious user: get immediate alerts for password resets and new device logins with high urgency flags
Commuter: listen to a short podcast-style voice briefing of important emails

FAQ

Ensure the digest.ts script exists, required environment variables are SET (GMAIL_OP_UUID, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, HAIKU_MODEL), and the Gmail CLI binary is built and executable.

How do I run the digest manually?

Run the digest script from your workspace: cd ~/own/amonic && bun run "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/digest.ts".

Can I change the triage categories or urgency mapping?

Yes. Update the category schema and urgency/emoji maps in the category-config reference and adjust prompts in the triage-prompts reference to fit your preferences.