telegram-botlisted
Install: claude install-skill skomax/skills
# Telegram Bot Development Skill
## When to Activate
- Creating or modifying Telegram bots
- Working with Telegram Bot API
- Setting up webhooks or long polling
- Building inline keyboards, callback handlers
- Telegram userbot or channel management
## Framework Selection
| Framework | Use Case | Style |
|-----------|----------|-------|
| **aiogram 3.x** | Production bots, complex logic, FSM | Async, router-based |
| **python-telegram-bot 21.x** | Simple bots, quick prototypes | Sync/async, handler-based |
| **Telethon** | Userbots, account automation, MTProto | Async, low-level |
| **pyrogram** | Userbots + bots, media handling | Async, modern API |
**Default choice: aiogram 3.x** - best for production bots.
## aiogram 3.x Project Structure
```
bot/
__init__.py
main.py # Entry point, bot startup
config.py # Settings from env
handlers/
__init__.py
start.py # /start, /help commands
admin.py # Admin commands
callbacks.py # Callback query handlers
errors.py # Error handler
keyboards/
__init__.py
inline.py # InlineKeyboardMarkup builders
reply.py # ReplyKeyboardMarkup builders
middlewares/
__init__.py
auth.py # User authentication
throttling.py # Rate limiting
services/
__init__.py
database.py # DB operations
api_client.py # External API calls
models/
__init__.py
user.py # User mod