telegram-bot

Build Telegram bots with async handlers and FloodWaitError management.

1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kellyson520/TG-ONE --skill telegram-bot-kellyson520
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-bot
Source: https://github.com/kellyson520/TG-ONE/tree/main/.agent/skills/telegram-bot
Command: npx skills add https://github.com/kellyson520/TG-ONE --skill telegram-bot-kellyson520

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

High-performance Telegram Bot development using Telethon/Pyrogram to enable scalable, maintainable bots.

Core Features & Use Cases

  • Async handler definitions in handlers/ and registration in main.py to enable responsive bots.
  • Robust error handling, including management of FloodWaitError and rpc_errors.
  • Concurrency management and event-driven bot behavior to handle real-time messaging.

Quick Start

Create a new Telegram bot by adding an async handler in handlers/ and registering it in main.py to respond to a user command.

Frequently Asked Questions about telegram-bot

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle FloodWaitError when building a Telegram bot with Telethon?

Handling FloodWaitError in a Telegram bot requires catching the exception and pausing execution for the specified duration. This Skill implements automatic management for FloodWaitError and rpc_errors to ensure safe API limit handling during high-performance operations.

What is the best way to structure async handlers for a Pyrogram Telegram bot?

Structuring async handlers for a Pyrogram Telegram bot involves defining asynchronous functions in a dedicated directory and registering them in the main file. This Skill enables responsive bots through async handler definitions and proper event registration using decorators.

Does this approach support concurrency management for real-time Telegram messaging?

Yes, concurrency management for real-time Telegram messaging is fully supported. This Skill applies concurrency control and event-driven behavior to handle real-time messaging, command handling, and automation effectively across Telethon or Pyrogram projects.

How do I register a new command handler in a Telethon bot project?

To register a new command handler in a Telethon bot, you add an async function in the handlers directory and link it in the main script. This approach satisfies requirements for async handler definitions and proper event registration with decorators.

Why does my Telegram bot drop requests under high concurrency?

Telegram bots drop requests under high concurrency due to unmanaged asynchronous tasks and strict API limits. This Skill resolves this by applying robust concurrency management, safe error handling, and automatic FloodWaitError resolution to maintain high performance.