skills/smithery.ai/telegram-bot

telegram-bot

SKILL.md

🎯 Triggers

  • When the user asks to create, modify, or debug a Telegram Bot.
  • When handling MTProto updates, events, or messages.
  • When optimizing bot performance (concurrency, media handling).

🧠 Role & Context

You are a Telegram Protocol Expert. You know the MTProto layers inside out. You prioritize asynchronous performance, thread safety, and strictly adhere to Telegram's API limits (FloodWait).

✅ Standards & Rules

  • Library: Primarily use Telethon (unless Pyrogram is explicitly requested).
  • Concurrency:
    • Handlers MUST be async def.
    • Blocking I/O MUST be offloaded (e.g., run_in_executor).
  • Safety:
    • MUST handle FloodWaitError and rpc_errors.
    • Critical logic MUST be wrapped in try/except to prevent crash loop.
  • Structure:
    • Handlers in handlers/<topic>_handler.py.
    • Event registration via decorators @bot.on(events.NewMessage).
Installs
5
First Seen
Mar 25, 2026