Agent-Skills.md

Agent Skills: Telegram (Skill Router)

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.

UncategorizedID: itechmeat/llm-code/telegram

Repository

itechmeat/llm-code
itechmeatLicense: MIT
2

Install this agent skill to your local

pnpm dlx add-skill https://github.com/itechmeat/llm-code/tree/HEAD/skills/telegram

Skill Files

Browse the full folder contents for telegram.

Download Skill

Loading file tree…

skills/telegram/SKILL.md

Skill Metadata

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."

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

Links

Related Skills