К основному содержанию
скилл CX Codex

email-triage — скилл для Claude Code: разбор писем и установка

Скилл email-triage для Claude Code сортирует недавние письма Gmail по трём категориям и уровням срочности. Разбирает входящие по запросу через команду бота /digest.

MIT 117 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill email-triage -a claude-code
Открыть на GitHub

Что делает email-triage

Скилл описывает разбор писем, который запускается командой бота /digest [hours]. Письма из Gmail делятся на категории «Система и безопасность», «Работа» и «Личное и семья», а внутри каждой отмечается срочность: от критической до низкой. Если значимых писем нет, бот сообщает о спокойном периоде.

В обработке участвуют Gmail CLI, промпт для модели Haiku и парсер, который превращает ответ в типизированные пункты дайджеста. Скилл проверяет, что код разбора и бинарный файл Gmail CLI на месте; если бинарного файла нет, предлагает собрать его через bun install --frozen-lockfile и bun run build. Без Gmail CLI получить письма для разбора не получится.

Это скилл для дайджеста по запросу. Запланированный дайджест работает в отдельном частном развёртывании и не использует код разбора этого плагина.

Какие задачи решает

  • Разобрать недавние письма Gmail по категориям
  • Выделить письма с критической и высокой срочностью
  • Собрать структурированный дайджест из ответа модели
  • Понять, почему для разбора не хватает Gmail CLI

Примеры запросов агенту

  • Разбери письма Gmail за последние несколько часов и сгруппируй их по категориям.
  • Подготовь дайджест через /digest 6 и отметь срочность каждого письма.
  • Проверь, почему разбор писем не запускается: найди проблему с Gmail CLI.

Как установить email-triage

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill email-triage -a claude-code

2Вручную: положить файлы

~/.claude/skills/email-triage/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/email-triage/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об email-triage

Как установить email-triage в Claude Code?

Выполните npx skills add terrylica/cc-skills --skill email-triage -a claude-code. Файл скилла появится по пути ~/.claude/skills/email-triage/SKILL.md.

Что делает email-triage?

Он помогает разбирать недавнюю почту Gmail: делит письма на три категории, назначает уровень срочности и формирует дайджест по запросу через /digest.

Чем разбор по /digest отличается от запланированного дайджеста?

Команда /digest запускает разбор из этого плагина по запросу. Запланированный дайджест работает в отдельном частном развёртывании со своей реализацией.

Исходный текст

SKILL.md · MIT
---
name: email-triage
description: Gmail Commander email triage - the three-category Haiku prompt and parser in lib/triage.ts, run on demand by the bot's /digest command. The scheduled digest runs in a private deployment with its own implementation. TRIGGERS - email digest, triage emails, digest categories
allowed-tools: Read, Bash, Grep, Glob
---

# Email Triage

How Gmail Commander sorts recent email into what needs attention, and where each digest actually comes from.

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## Two different digests — do not confuse them

| Digest                      | Trigger                                  | Code                                                                    |
| --------------------------- | ---------------------------------------- | ----------------------------------------------------------------------- |
| On-demand `/digest [hours]` | A user sends it to the bot (default 6 h) | This plugin: `scripts/lib/commands.ts` + `scripts/lib/triage.ts`        |
| Scheduled digest            | Several times a day, unattended          | The private deployment's `GmailDigest` service — its own implementation |

The scheduled digest runs in a **private Restate tenant on an always-on Mac mini** and does not import this plugin's triage code. Its schedule, prompt, alerting and failures are operated through that deployment's own repository runbook.

This plugin no longer ships a scheduled digest entry point: the laptop launchd job `com.example.gmail-commander-digest` was retired on 2026-09-24, and its `scripts/digest.ts` (with the Kokoro podcast-style voice briefing in `scripts/lib/tts-client.ts`) was removed on 2026-09-26 once nothing imported it. Do not recreate either.

## Mandatory Preflight

### Step 1: Check the triage code exists

```bash
PLUGIN="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander"
ls -la "$PLUGIN/scripts/lib/triage.ts" 2>/dev/null || echo "TRIAGE_NOT_FOUND"
```

### Step 2: Verify the Gmail CLI binary (the triage input comes from it)

```bash
ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/gmail-cli/gmail" 2>/dev/null || echo "BINARY_NOT_FOUND"
```

**If BINARY_NOT_FOUND**: Build it from the committed lockfile:

```bash
cd "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/gmail-cli" && bun install --frozen-lockfile && bun run build
```

## Three-Category Triage System

| Category          | Examples                                                          |
| ----------------- | ----------------------------------------------------------------- |
| SYSTEM & SECURITY | Exchange alerts, 2FA codes, password resets, new device logins    |
| WORK              | Deadlines, invoices, contracts, GitHub PRs, professional requests |
| PERSONAL & FAMILY | Friends/family messages, appointments, vehicle service, health    |

Urgency levels within each: CRITICAL > HIGH > MEDIUM > LOW. When nothing qualifies, the model answers exactly `NO_SIGNIFICANT_EMAILS` and the bot reports a quiet window.

## Pipeline (`/digest [hours]`)

1. `fetchRecentEmails(hours)` runs `gmail search newer_than:<hours>h -n 50 --json` through `GMAIL_CLI_BIN`.
2. `formatEmailsForTriage()` renders the messages; `ANTI_SKILL_PREFIX` is prepended so the model ignores any skill or tool listings in its context.
3. One Agent SDK call with `TRIAGE_SYSTEM_PROMPT` on `HAIKU_MODEL` (no tools, one turn).
4. `isSkillContaminated()` discards a response that role-plays a skill instead of triaging.
5. `parseTriageResponse()` turns the text into typed items, and `formatDigestHtml()` renders them with the category and urgency emoji maps.

## Source Map

| Concern                                  | File                                                                     |
| ---------------------------------------- | ------------------------------------------------------------------------ |
| System prompt, anti-skill prefix, parser | [`scripts/lib/triage.ts`](../../scripts/lib/triage.ts)                   |
| `/digest` command handler                | [`scripts/lib/commands.ts`](../../scripts/lib/commands.ts)               |
| Category/urgency emoji maps, digest HTML | [`scripts/lib/telegram-format.ts`](../../scripts/lib/telegram-format.ts) |
| Gmail fetch                              | [`scripts/lib/gmail-client.ts`](../../scripts/lib/gmail-client.ts)       |

## Post-Change Checklist

- [ ] YAML frontmatter valid (no colons in description)
- [ ] Trigger keywords current
- [ ] Path patterns use $HOME not hardcoded paths
- [ ] `lib/triage.ts` exports unchanged in shape (the bot and its deployment import them)

## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Заметки, задачи и проекты» →
cowork-inbox-triage OneWave-AI Скилл cowork-inbox-triage для Claude Code сортирует входящие письма через коннекторы Microsoft 365 или Gmail. Обрабатывает почту за последние 24 часа и готовит черновики ответов. CX Codex +1 106установок gws-gmail-triage официальный googleworkspace Скилл gws-gmail-triage для Claude Code, Codex, Cursor и других IDE показывает краткий список непрочитанных писем с отправителем, темой и датой. Запускается одной командой и работает только на чтение — почтовый ящик не меняет. CX Codex +1 48 900установок inbox-triage Alireza Rezvani Скилл inbox-triage для Claude Code разбирает новые письма по вашей классификации, изучает неизвестных отправителей и готовит черновики ответов. Запускается по просьбе обработать почту или по расписанию. CX Codex +1 408установок email-pair Alireza Rezvani Плагин email-pair организует разбор почты в связке из двух скиллов: интервью для настройки базы знаний и регулярная сортировка входящих. Никогда не отправляет письма автоматически. ★ 30 251звёзд репо recipe-email-drive-link официальный googleworkspace Скилл recipe-email-drive-link для Claude Code, Codex, Cursor и других ИИ-редакторов автоматизирует отправку ссылок на файлы Google Drive по почте. Находит файл, открывает доступ и отправляет письмо с сообщением — всё в одной цепочке команд. CX Codex +1 32 500установок c-email daxaur Скилл c-email управляет почтой через консольные утилиты gog для Gmail и himalaya для стандартного IMAP. Позволяет агенту читать письма, отвечать и наводить порядок в ящике. CX Codex +1 ★ 179звёзд репо

Из того же набора79

Весь набор →
pueue-job-orchestration Скилл pueue-job-orchestration управляет длинными задачами и пакетами команд через очередь pueue с контролем параллелизма и сохранением логов. CX Codex +1 120установок distributed-job-safety Скилл distributed-job-safety для Claude Code находит гонки и сбои в параллельных пайплайнах на pueue, moon и systemd-run. Выявляет риски при одновременной записи файлов и работе с общими ресурсами. CX Codex +1 120установок project-directory-migration Скилл project-directory-migration переносит сессии, историю и контекст Claude Code, когда вы переименовываете или перемещаете папку проекта. Работает в интерактивном режиме с dry-run проверкой и откатом. CX Codex +1 119установок infra-deploy Скилл infra-deploy разворачивает self-hosted Cal.com в GCP Cloud Run с базой Supabase PostgreSQL или поднимает его локально через Docker Compose. CX Codex +1 119установок bot-process-control Скилл bot-process-control регламентирует мониторинг процессов Gmail Commander и защищает от запуска конфликтующих локальных поллеров Telegram на рабочей станции. CX Codex +1 117установок interactive-bot Скилл interactive-bot объясняет устройство Telegram-бота Gmail Commander: слэш-команды для почты, ИИ-роутинг свободного текста через MCP, сессии compose/reply. CX Codex +1 114установок symmetric-dogfooding Скилл symmetric-dogfooding организует двустороннее интеграционное тестирование между двумя репозиториями перед релизом без использования моков. CX Codex +1 112установок calcom-access Скилл calcom-access для Claude Code и пяти других платформ даёт агенту доступ к Cal.com API для работы с бронированиями, типами событий, расписаниями и доступностью слотов. Ключ API берётся из 1Password через CALCOM_OP_UUID. CX Codex +1 107установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой