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).
- Handlers MUST be
- Safety:
- MUST handle
FloodWaitErrorandrpc_errors. - Critical logic MUST be wrapped in
try/exceptto prevent crash loop.
- MUST handle
- Structure:
- Handlers in
handlers/<topic>_handler.py. - Event registration via decorators
@bot.on(events.NewMessage).
- Handlers in