interactive-bot
Gmail Commander Telegram bot with slash commands, inline keyboards, and AI routing. TRIGGERS - telegram bot, bot commands, inbox bot
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill interactive-botIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill implements a Telegram bot for Gmail management. It executes local scripts and uses an AI model to route natural language commands to Gmail tools. The skill includes instructions for the agent to modify its own source file to 'evolve.' The primary security risks are indirect prompt injection from email content influencing the agent's behavior and the potential for these instructions to permanently alter the skill's logic when processing untrusted data.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/1 file flagged
What does this agent skill do?
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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/terrylica/cc-skills/interactive-bot">View interactive-bot on skillZs</a>