interactive-bot_skill

Overview

This skill provides a Gmail Commander Telegram bot that exposes slash commands, inline keyboards, and AI-powered free-text routing to manage Gmail from Telegram. It combines deterministic CLI commands for fast operations with an intelligent agent layer for natural-language requests and routing. Built for secure, single-chat operation with safety controls to prevent misuse.

How this skill works

The bot exposes a set of slash commands (inbox, search, read, compose, reply, drafts, digest, status, help) that call Gmail tools directly for predictable results. Free-text messages are routed through an agent SDK (Haiku) which can call Gmail MCP tools (list, search, read, draft) and return structured responses. Built-in guards enforce single-agent mutex, per-query timeouts, circuit breaking, contamination detection, and chat-ID-based authorization.

When to use it

• Quickly view recent inbox items and drafts from Telegram
• Search Gmail with Gmail query syntax without leaving chat
• Read or reply to specific messages using message IDs
• Compose new emails via a guided multi-step flow
• Use natural-language requests to summarize, search, or route emails via the AI agent

Best practices

• Ensure TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID are set before starting the bot
• Use slash commands for deterministic tasks and free-text for summaries or complex routing
• Keep the authorized TELEGRAM_CHAT_ID restricted to trusted accounts
• Monitor circuit-breaker and agent failure logs to avoid unexpected downtime
• Run the mandatory preflight checks and validate environment variables before launch

Example use cases

• /inbox to scan the latest messages when away from desktop
• Type “summarize my unread messages” to have the agent produce a digest
• /search "label:project from:alice" to find project emails quickly
• /compose to start a multi-step guided email creation and send flow
• /read <message-id> to display a specific email with consistent rendering rules