Skill

interactive-bot

Gmail Commander Telegram bot with slash commands, inline keyboards, and AI routing. TRIGGERS - telegram bot, bot commands, inbox bot, email bot, start bot, stop bot, compose email via telegram.

From gmail-commander

Install

Run in your terminal

npx claudepluginhub terrylica/cc-skills --plugin gmail-commander

Tool Access

This skill is limited to using the following tools:

ReadBashGrepGlob

Supporting Assets

View in Repository

references/evolution-log.md

Skill Content

Similar Skills

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

everything-claude-code

139.2k

agent-payment-x402

Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.

everything-claude-code

139.2k

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

139.2k

Stats

Parent Repo Stars28

Parent Repo Forks4

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

Interactive Bot

Gmail Commander Telegram bot — slash commands for email access + AI-powered free-text routing.

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.

Mandatory Preflight

Step 1: Check Bot Script Exists

ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/bot.ts" 2>/dev/null || echo "SCRIPT_NOT_FOUND"

Step 2: Verify Environment

echo "TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN:+SET}"
echo "TELEGRAM_CHAT_ID: ${TELEGRAM_CHAT_ID:-NOT_SET}"
echo "GMAIL_OP_UUID: ${GMAIL_OP_UUID:-NOT_SET}"
echo "HAIKU_MODEL: ${HAIKU_MODEL:-NOT_SET}"

Bot Commands (Sidebar Menu)

Command	Description
/inbox	Show recent inbox emails
/search	Search emails (Gmail query syntax)
/read	Read email by ID
/compose	Compose a new email
/reply	Reply to an email
/drafts	List draft emails
/digest	Run email digest now
/status	Bot status and stats
/help	Show all commands

Two-Tier Command System

Tier 1 — Deterministic: Slash commands call Gmail CLI directly.

Tier 2 — Intelligent: Free-text messages route through Agent SDK (Haiku) with 4 Gmail MCP tools (list, search, read, draft).

Safety Controls

Mutex: 1 agent query at a time
Timeout: 2-minute maximum per query
Circuit Breaker: 3 failures in a row disables agent for 10 minutes
Anti-contamination: Skill contamination detection on all agent responses
Auth Guard: Only responds to authorized TELEGRAM_CHAT_ID

Running Manually

cd ~/own/amonic && bun run "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/gmail-commander/scripts/bot.ts"

References

command-reference.md — All commands with examples
compose-flow.md — Multi-step compose/reply state machine
display-patterns.md — Email rendering rules

Post-Change Checklist

YAML frontmatter valid (no colons in description)
Trigger keywords current
Path patterns use $HOME not hardcoded paths

Post-Execution Reflection

After this skill completes, reflect before closing the task:

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

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