Build or update the BlueBubbles external channel plugin for Moltbot (extension package, REST...
npx skills add itechmeat/llm-code --skill "telegram"
Install specific skill from multi-skill repository
# Description
Telegram Bot development playbook: bot fundamentals, aiogram 3 patterns (handlers/middlewares/FSM), webhooks, keyboard UX, inline mode, Mini Apps, payments (Stars/subscriptions), authentication. Keywords: Telegram, aiogram, Bot API, webhook, handlers, middlewares, FSM, inline keyboard, reply keyboard, callback_query, inline mode, Mini Apps, Web Apps, payments, Telegram Stars, Login Widget.
# SKILL.md
name: telegram
description: "Telegram Bot development playbook: bot fundamentals, aiogram 3 patterns (handlers/middlewares/FSM), webhooks, keyboard UX, inline mode, Mini Apps, payments (Stars/subscriptions), authentication. Keywords: Telegram, aiogram, Bot API, webhook, handlers, middlewares, FSM, inline keyboard, reply keyboard, callback_query, inline mode, Mini Apps, Web Apps, payments, Telegram Stars, Login Widget."
version: "3.24.0"
release_date: "2026-01-02"
Telegram (Skill Router)
Router skill: pick the reference that matches your task.
Quick Navigation
| Task | Reference |
|---|---|
| New to Telegram bots | bots-overview.md |
| Bot capabilities overview | bot-features.md |
| API methods/types | bot-api.md |
| Webhook setup & security | webhooks.md |
| aiogram 3 handlers/FSM | aiogram-patterns.md |
| Keyboard UX | keyboard-design.md |
| Inline mode | inline-mode.md |
| Mini Apps (Web Apps) | mini-apps.md |
| Payments (Stars) | payments.md |
| Authentication (Login Widget, URL Auth) | authentication.md |
| Rate limits & performance | performance.md |
Critical Prohibitions
- ❌ No polling + webhooks simultaneously for same bot
- ❌ No hardcoded tokens/secrets — use environment variables
- ❌ No secrets in callback_data or logs
- ❌ No ignoring
answer_callback_query— always respond - ❌ No blocking work in webhook handlers — use background tasks
- ❌ No trusting Login Widget data without hash verification
Definition of Done
- [ ] Webhook handlers validate
X-Telegram-Bot-Api-Secret-Token - [ ] Keyboards: max 2 buttons per row, mobile-first
- [ ] Callback data validated, not trusted blindly
- [ ] Handlers are idempotent or have de-duplication
Related Skills
- PostgreSQL — for database layer
- FastAPI — for API layer (if exists)
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.