mcpField
T
telegram

telegram

github.com/itechmeatDevelopment2374 installsUpdated 2w ago
Repository

About telegram

A routing skill for Telegram bot development that points to task-specific references for the Bot API, webhooks, aiogram, and Mini Apps. It also collects security cautions and recent Bot API and aiogram changes.

Key features

  1. 01Task-based reference navigation
  2. 02Bot API and aiogram patterns
  3. 03Webhook security guidance
  4. 04Token and callback-data cautions
  5. 05Recent release notes

Use cases

  1. 01Find Telegram Bot API methods
  2. 02Configure and secure webhooks
  3. 03Design aiogram handlers and FSMs
  4. 04Review keyboards, payments, or authentication

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/itechmeat/llm-code --skill telegram

After installing, type/telegramin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
aiogram-patterns.md
authentication.md
bot-api.md
bot-features.md
bots-overview.md
inline-mode.md
keyboard-design.md
mini-apps.md
payments.md
performance.md
webhooks.md

Details

From the project README

Telegram (Skill Router)

Router skill: pick the reference that matches your task.

Quick Navigation

TaskReference
New to Telegram botsbots-overview.md
Bot capabilities overviewbot-features.md
API methods/typesbot-api.md
Webhook setup & securitywebhooks.md
aiogram 3 handlers/FSMaiogram-patterns.md
Keyboard UXkeyboard-design.md
Inline modeinline-mode.md
Mini Apps (Web Apps)mini-apps.md
Payments (Stars)payments.md
Authentication (Login Widget, URL Auth)authentication.md
Rate limits & performanceperformance.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

Release Note (3.29.x - 3.31.x / Bot API 10.1 - 10.3)

  • aiogram 3.31.0 adds full Bot API 10.3 support, bringing rich messages (rich block buttons, expandable block quotations, document blocks), ephemeral messages (EphemeralMessageParameters, message drafts with can_stop/keep_on_stop), and new reply-markup controls (DisabledButton, force_reply). 3.30.0 added Bot API 10.2 and 3.29.0 added Bot API 10.1. Assume the newer method/type schema when targeting recent aiogram.
  • 3.31.0 also fixes webhook-path dispatcher context loss, Bot API-level parse_mode not applying to newer photo/video entities, live-photo content-type detection, and territory-specific i18n locale resolution; vulnerable dependencies were bumped to patched versions.
  • 3.29.1 fixes a severe (exponential) slowdown when validating nested unions, so heavy handler/filter models parse far faster on the patched line.

Release Note (3.28.x / Bot API 10.0)

  • aiogram 3.28.x adds Bot API 10.0 support, bringing guest-mode updates, richer poll/media flows, live photos, reaction-management methods, and managed/business-bot access settings.
  • The 3.28.1+ patch line also fixes InputPollOption.media validation, so poll/media integrations should assume the newer schema and the patched aiogram serializer behavior.

Links

Related Skills

Comments

Markdown supported