telegram-bot-ui
llms.txt11 starsChanged todayMITView on GitHub
Telegram bot UI/UX skill, updated for every Bot API release. Design, build, publish with and operate bots: texts, inline/reply keyboards, colored and disabled buttons, premium custom emoji, force_reply forms, navigation, streaming AI replies with Stop, private replies in groups, Rich Messages, HTML widgets with server handlers, TON wallet, topics, formatting, localization; whole products (shop with Stars, support, booking, onboarding, subscriptions, inline mode, business); channel posts (approve, publish once, edit, cross-post, mailings); an agent working via its own bot (notify, ask,…
In this repositoryOne other file it gives its agents.
- telegram-bot-uiSkill
The file
We split this llms.txt into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 12
Use premium emoji packs: pick one custom emoji pack, resolve real ids, apply it to buttons, texts, rich messages and posts with …
- Distinctive: line 13
Look up the whole Bot API: methods, types and fields from a local catalog.
≈ “Common” is an estimate: at least 1 in 5 of the 3,727 llms.txt files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
# telegram-bot-ui > Telegram bot UI/UX skill, updated for every Bot API release. Design, build, publish with and operate bots: texts, inline/reply keyboards, colored and disabled buttons, premium custom emoji, force_reply forms, navigation, streaming AI replies with Stop, private replies in groups, Rich Messages, HTML widgets with server handlers, TON wallet, topics, formatting, localization; whole products (shop with Stars, support, booking, onboarding, subscriptions, inline mode, business); channel posts (approve, publish once, edit, cross-post, mailings); an agent working via its own bot (notify, ask, approve, progress, hooks, MCP); offline lookup of every Bot API method and field, plus their server side. Use for 'improve this bot's menu', 'add a Stop button', 'post this to our channel', 'message me when the build is done', 'make a widget', 'use premium emoji', 'can't parse entities', 'does the Bot API have X'. Do NOT use for webhook hosting, databases or auth unrelated to Telegram, or Microsoft .rtf files. An Agent Skill in `skills/telegram-bot-ui/`. Start with its `SKILL.md`; open other files only when the task needs them. Paths are relative to the repository root. Capabilities: - Build and audit bot interfaces: texts, inline and reply keyboards, colored and disabled buttons, navigation, forms, streaming AI replies with Stop, ephemeral replies in groups, Rich Messages, tables, formatting, localization. - Product flows and use cases: shops, support, events, queues, AI assistants and 35 more families: find an example by intent; stale buttons, double submit, audience leaks. - Publish to Telegram channels: compose, validate, preview, approve, schedule and publish channel posts without double posting. - Operate as an agent through a bot: allowlisted operators, approval-bound actions, prompt injection in inbound messages, MCP bridge. - Build HTML widgets: Bot API 10.4 widgets: size limit, production context, caption and text fallback, widget_query, shared widgets, TON wallet. - Use premium emoji packs: pick one custom emoji pack, resolve real ids, apply it to buttons, texts, rich messages and posts with all-or-nothing fallback; never invent an id. - Look up the whole Bot API: methods, types and fields from a local catalog; validate a payload before sending; never invent a field. ## Entry point - [Telegram Bot UI](skills/telegram-bot-ui/SKILL.md): Portable, SDK-agnostic skill for everything a Telegram bot shows and sends: bot screens, whole products, channel posts, HTML widgets,... ## References - [Security for agent-operated bots](skills/telegram-bot-ui/references/agent-bot-security.md): An agent with a Telegram bot is a remote control for the agent's machine. Whoever can send it messages can try to steer it. Every rule... - [Agent-operated bots: an AI agent working through its own Telegram bot](skills/telegram-bot-ui/references/agent-operated-bots.md): This file is for the case where **the bot is the agent's interface**: a coding agent, CI job or autonomous worker reports to its human... - [Bot API catalog: offline lookup, payload checks, refresh](skills/telegram-bot-ui/references/api-catalog.md): The whole Bot API (every method and type, with fields, required flags, return types and union members) is committed as JSON in... - [Auditing an existing bot (analyze → diagnose → propose)](skills/telegram-bot-ui/references/auditing-existing-bots.md): Heuristics of this skill (first written 2026-08-05, reviewed against Bot API 10.4 on 2026-11-15). Version gates: `ui-changelog.md`;... - [Bot API 10.3 / 10.4 coverage registry](skills/telegram-bot-ui/references/bot-api-10.3-10.4.md): Availability is five separate questions — spec, production, Bot API server, installed SDK, client rendering. "production" below is about... - [Bot archetypes: which features fit which bot (Bot API 10.4)](skills/telegram-bot-ui/references/bot-archetypes.md): Pick the archetype(s), take the **core screens**, add the features marked ✓ where they serve the user's task, and avoid the ✗ traps.... - [Bot style profile: the knobs that tune a bot](skills/telegram-bot-ui/references/bot-style-profile.md): The profile is one JSON file in the bot's project (default `docs/telegram-ui/profile.json`) that records every interface decision of the... - [Business accounts (business bots)](skills/telegram-bot-ui/references/business-accounts.md): A user connects your bot to their Telegram account (Settings → Telegram Business → Chatbots). The bot then receives that account's... - [Buttons, emphasis, and `style` colors](skills/telegram-bot-ui/references/buttons-and-styles.md): Everything here applies to both `InlineKeyboardButton` and `KeyboardButton` unless stated otherwise. Layout specifics:... - [Case study: btc-tracker (aiogram 3.31, built for Bot API 9.4–10.2)](skills/telegram-bot-ui/references/case-study-btc-tracker.md): The bot watches Bitcoin addresses and watch-only public keys, sends transaction and confirmation alerts, shows balances and statistics,... - [Channel post design](skills/telegram-bot-ui/references/channel-post-design.md): How a channel post should look and which Bot API format carries it. Pipeline (render, validate, publish once, edit, fan-out):... - [Channels, notifications, and broadcasting](skills/telegram-bot-ui/references/channels-and-broadcasting.md): Entry point for anything that is **posted or broadcast** rather than replied in a chat: channel posts, announcements in groups, and... - [Chat administration and member updates](skills/telegram-bot-ui/references/chat-administration.md): Bans, restrictions, promotions, permissions, invite links, join requests (incl. the 10.1 join-request queries), member tags, and the... - [Consistency between screens and states, and the final review](skills/telegram-bot-ui/references/consistency-and-review.md): A bot feels "designed" when the same thing looks and is named the same everywhere. Most UX complaints about bots are consistency... - [Content-shape detection — recognizing what the text wants to be](skills/telegram-bot-ui/references/content-shape-detection.md): Heuristics of this skill (first written 2026-08-05, reviewed 2026-11-15). Surface choice (message, rich document, keyboard, widget, Mini... - [Custom emoji — on buttons and in text](skills/telegram-bot-ui/references/custom-emoji.md): Two different mechanisms, one eligibility rule: - [Dynamic feedback: streaming, progress, and loaders](skills/telegram-bot-ui/references/dynamic-feedback-and-streaming.md): A bot cannot animate arbitrary UI frame by frame. What "animation" actually means in a Telegram chat is one of these: - [Premium emoji in posts, long texts and rich messages](skills/telegram-bot-ui/references/emoji-in-posts.md): by bots that purchased additional usernames on Fragment or in the messages directly sent by the bot to private, group and supergroup... - [Emoji packs: choosing, resolving and applying a premium icon family](skills/telegram-bot-ui/references/emoji-packs.md): Use it whenever you build or restyle a bot, or compose a post, and icons/emoji are involved. - [Personal answers on a shared timeline (ephemeral, Bot API 10.2–10.4)](skills/telegram-bot-ui/references/ephemeral-and-personal.md): One member must never see another member's state: build the content from the **presser's** data on the server, check... - [Errors, fallbacks, and old clients](skills/telegram-bot-ui/references/errors-and-fallbacks.md): Content: - [Reuse, compose and extend the example library](skills/telegram-bot-ui/references/example-library.md): Use this when building a new bot feature, choosing examples, or adding a scenario the library does not cover. Small wording fixes do not... - [Worked scenarios (before → after)](skills/telegram-bot-ui/references/examples-before-after.md): Sixteen situations that cover most real UI requests: 1-7 are single-screen fixes, 8-16 come from the product playbooks (recipes 20-29... - [Format and surface selection](skills/telegram-bot-ui/references/format-selection.md): Three different "HTML"s exist and never mix: regular-message `parse_mode=HTML`, **Rich HTML** (`InputRichMessage.html`), and **widget... - [Gifts and stories](skills/telegram-bot-ui/references/gifts-and-stories.md): Sending gifts and Telegram Premium paid from the bot's Stars, reading gifts users and chats own, unique (collectible) gifts, the gift... - [Inline keyboards](skills/telegram-bot-ui/references/inline-keyboards.md): `InlineKeyboardMarkup` = `inline_keyboard`: an array of rows, each an array of `InlineKeyboardButton`. It belongs to **one specific... - [Inline mode](skills/telegram-bot-ui/references/inline-mode.md): Users type `@yourbot query` in **any** chat and pick a result; the message is sent by the user "via @yourbot". Also covers the switch... - [Limits and splitting](skills/telegram-bot-ui/references/limits-and-splitting.md): Keep these constants in **one place** in the project; never scatter magic numbers across call sites. - [Localization and RTL](skills/telegram-bot-ui/references/localization-and-rtl.md): The whole interface — message text, button labels, command descriptions — must survive translation and mixed text direction. Localized... - [Media and files](skills/telegram-bot-ui/references/media-and-files.md): Sending files (upload vs `file_id` vs URL), size limits, albums, `InputMedia*`, thumbnails and covers, live photos, downloading with... - [Microcopy: message texts, titles, captions, button labels](skills/telegram-bot-ui/references/microcopy-and-labels.md): Text is the bot's primary interface. This is the first layer to fix and the one that most often makes color and emoji unnecessary. - [Mini App bridge (bot side only)](skills/telegram-bot-ui/references/mini-apps-bridge.md): How a bot **launches** Mini Apps and **receives data** from them, and how to trust that data. Mini App front-end internals (the... - [Navigation, screens, and chat-level chrome](skills/telegram-bot-ui/references/navigation-and-flows.md): A bot's "pages" are messages. Its "router" is `callback_data` plus conversation state. Without an explicit map, navigation rots into... - [Official sources and verification log](skills/telegram-bot-ui/references/official-sources.md): When Telegram ships a newer Bot API version, or today is past the date above and the task is version-sensitive: 1. Read the **Bot API... - [Onboarding and first run](skills/telegram-bot-ui/references/onboarding-and-first-run.md): The first minute decides whether a bot is used again. A good first run answers three questions in this order: *what is this*, *what do I... - [Payments and Telegram Stars](skills/telegram-bot-ui/references/payments-and-stars.md): Selling digital goods and services (Stars, `XTR`), physical goods (a payment provider), subscriptions, paid media, refunds and the bot's... - [Personalization and links](skills/telegram-bot-ui/references/personalization-and-links.md): Two adjacent surfaces that decide whether a bot feels *addressed to me* and whether its actions are reachable. - [Polls, checklists and reactions](skills/telegram-bot-ui/references/polls-checklists-and-reactions.md): Native polls and quizzes (with the 9.6 and 10.0 extensions: multiple correct answers, revoting, added options, media, members-only,... - [Project adaptation (investigate before you change)](skills/telegram-bot-ui/references/project-adaptation.md): This skill is project-agnostic. Before touching anything, build an accurate map of how the target project builds its **interface** —... - [Publishing pipeline: from source material to a channel post, exactly once](skills/telegram-bot-ui/references/publishing-pipeline.md): How an agent operates a bot as a **publisher**: turn source material (a feed item, a CMS entry, an AI summary) into a channel post and... - [Deep redesign path: research the project, rethink the menus, tune the bot](skills/telegram-bot-ui/references/redesign-orchestration.md): Use this path when the request is bigger than fixing screens: *"make the bot feel like our product"*, *"rethink the whole menu"*, *"redo... - [Regular formatting — complete reference](skills/telegram-bot-ui/references/regular-formatting.md): There are three ways to style a **regular** message: `parse_mode="HTML"`, `parse_mode="MarkdownV2"`, or an explicit `entities` array.... - [Reply keyboards, ForceReply, and the input field](skills/telegram-bot-ui/references/reply-keyboards.md): `ReplyKeyboardMarkup` replaces the user's letter keyboard with your buttons. Pressing a plain button **sends its `text` as an ordinary... - [Rich media](skills/telegram-bot-ui/references/rich-media.md): Covers media inside Rich Messages (`InputRichMessageMedia` + media blocks) and the choice between embedding media vs. separate media... - [SDK compatibility](skills/telegram-bot-ui/references/sdk-compatibility.md): The project's SDK — not your memory — decides which UI and formatting features are reachable. Establish the SDK, its version, and the... - [Security and escaping](skills/telegram-bot-ui/references/security-and-escaping.md): Convert through a controlled builder and whitelist. - Whitelist **tags**, **attributes**, and **URL schemes**. Reject everything else. -... - [Specialized 10.3/10.4 modules (on demand)](skills/telegram-bot-ui/references/specialized-updates.md): 10.3: `can_send_welcome_messages` in `ChatAdministratorRights`, `ChatMemberAdministrator` and `promoteChatMember` — "manage chat welcome... - [Streaming, Stop, and editing (engineering)](skills/telegram-bot-ui/references/streaming-and-editing.md): STARTED → GENERATING → COMPLETED (model finished → final send) → STOP_REQUESTED → STOPPED (Stop pressed → cancel upstream → policy) →... - [Tables — the flagship capability](skills/telegram-bot-ui/references/tables.md): Reach for a table when the content is **two or more parallel records with shared attributes**, or **label → value pairs** you want... - [Telegram message capabilities](skills/telegram-bot-ui/references/telegram-capabilities.md): This is a compact map, not a copy of the docs. When the task depends on an exact field, open the official page for that object/method... - [Testing playbook](skills/telegram-bot-ui/references/testing-playbook.md): `icon_custom_emoji_id`, and that every `callback_data` is unchanged and ≤64 bytes. - Rendered output string for the chosen `parse_mode`,... - [Contexts and addressing](skills/telegram-bot-ui/references/topics-and-contexts.md): `MessageGenerationStopped` carries `chat` + optional `message_thread_id` + `draft_id` — match all three. Per-conversation state... - [UI-relevant Bot API history and version gates](skills/telegram-bot-ui/references/ui-changelog.md): Only the entries that change what a bot's **interface** can do. Every line below was read from the official changelog... - [Update intake and delivery](skills/telegram-bot-ui/references/updates-and-delivery.md): How updates reach the bot (`getUpdates` vs webhook), what `allowed_updates` really does, offsets, the secret token, ordering and... - [Use-case playbooks: complete product models for "build me a bot for X"](skills/telegram-bot-ui/references/use-case-playbooks.md): For broader discovery, search `recipes/use-cases.json` and read the [reuse/extension contract](example-library.md). Recipes R80–R87 add... - [Visual language: icons, emoji and text structure](skills/telegram-bot-ui/references/visual-language.md): A professional bot looks like **one product**: the same symbol always means the same thing, icons come from one drawing style, every... - [Wallet and TON features (Bot API 10.4)](skills/telegram-bot-ui/references/wallet-and-ton.md): Amounts are decimal strings in the smallest units (nanotons): never parse as float for money. - [Widget design system (Bot API 10.4, widget profile 1)](skills/telegram-bot-ui/references/widget-design-system.md): A widget is part of a message, not a web page. It should read like Telegram drew it: the chat's palette and text size, the client's own... - [Widget patterns: state, data, interaction (Bot API 10.4)](skills/telegram-bot-ui/references/widget-patterns.md): Ask in order; take the first "yes". - [HTML widgets (Bot API 10.4)](skills/telegram-bot-ui/references/widgets.md): A widget is **one self-contained HTML document drawn inside a message**: fixed code plus state that only the bot writes. It runs in... ## Recipes - [01 — AI assistant with a rich streamed answer and Stop](skills/telegram-bot-ui/recipes/01-ai-assistant.md): Registry rows: `10.3-G01`, `10.3-G02` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [02 — Interactive document: compact table, expandable quote, attached file, buttons, quoting](skills/telegram-bot-ui/recipes/02-interactive-document.md): Registry rows: `10.4-Q01`, `10.4-Q02`, `10.4-X02`, `10.3-R01`, `10.3-R02`, `10.3-R03`, `10.3-R04`, `10.3-R05`, `10.3-R06`, `10.3-R07`... - [03 — Multi-step form: keyboard plus reply field, disabled Submit, Back, no duplicates](skills/telegram-bot-ui/recipes/03-multi-step-form.md): Registry rows: `10.3-K01`, `10.3-K02` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [04 — Shared card and personal panels in a group](skills/telegram-bot-ui/recipes/04-shared-card-personal-panel.md): Registry rows: `10.4-E01`, `10.4-E02`, `10.3-E01`, `10.3-E03` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [05 — Interactive widget in a private chat (production)](skills/telegram-bot-ui/recipes/05-private-widget.md): Registry rows: `10.4-W01`, `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [06 — Shared widget: one poll in many chats, revisions, coalesced updates](skills/telegram-bot-ui/recipes/06-shared-widget.md): Registry rows: `10.4-W03`, `10.4-W05`, `10.4-W09`, `10.4-W10`, `10.4-W11` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [07 — Wallet interaction from a widget (pay, sign, confirm)](skills/telegram-bot-ui/recipes/07-wallet.md): Registry rows: `10.4-W06`, `10.4-T01`, `10.4-T02`, `10.4-X03` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [08 — Bot with several conversation topics](skills/telegram-bot-ui/recipes/08-multi-topic-bot.md): Registry rows: `10.4-X07` (`recipes/registry.json`). Verified 2026-11-12, Bot API 10.4. - [09 — Monitoring bot upgraded to 10.3/10.4 (btc-tracker case study)](skills/telegram-bot-ui/recipes/09-tracker-bot.md): Registry rows: none of its own — combines `10.4-W02`, `10.4-W03`, `10.4-W08`, `10.4-W09`, `10.3-R04`, `10.3-K01`, `10.3-K02` with 9.4... - [20 — Shop: catalog → product → cart → checkout with Telegram Stars or a provider invoice](skills/telegram-bot-ui/recipes/20-shop.md): Product recipe (combines mechanisms; no registry row of its own). Uses `10.3-K01` disabled buttons, `10.3-R04` compact tables, 9.4... - [21 — Support desk: a private chat for the customer, one forum topic per ticket for the team](skills/telegram-bot-ui/recipes/21-support-desk.md): Product recipe (combines mechanisms; no registry row of its own). Uses `10.3` inline `force_reply`, `10.3` disabled buttons, 9.4 button... - [22 — Appointment booking: service → day → time → confirm, with reminders, reschedule and cancel](skills/telegram-bot-ui/recipes/22-booking.md): Product recipe (combines mechanisms; no registry row of its own). Uses `10.3-K01` disabled buttons, regular-HTML `<tg-time>` (the... - [23 — Onboarding and first run: deep links, language, permissions, empty states, returning users](skills/telegram-bot-ui/recipes/23-onboarding.md): Product recipe (no registry row of its own). Uses 9.4 button `style`, older deep-link and reply-keyboard features, and the bot profile... - [24 — Settings and preferences: toggles, back stack, destructive actions with confirm and undo](skills/telegram-bot-ui/recipes/24-settings.md): Product recipe (no registry row of its own). Uses 10.3 disabled buttons, 9.4 `style`. Verified 2026-11-15 against Bot API 10.4. Tags:... - [25 — Subscription: paywall, one 7-day trial, a Stars subscription, cancel and expiry](skills/telegram-bot-ui/recipes/25-subscription-paywall.md): Product recipe (combines mechanisms; no registry row of its own). Uses `createInvoiceLink` with `subscription_period`,... - [26 — Learning bot: course map → lesson → quiz → result → streak → daily reminder](skills/telegram-bot-ui/recipes/26-learning-bot.md): Product recipe (combines mechanisms; no registry row of its own). Uses 10.3 rich blocks (checklist items, expandable quotation, button... - [27 — Assistant as a product: modes, streamed answer with Stop, feedback, regenerate, history, files](skills/telegram-bot-ui/recipes/27-ai-assistant-product.md): Product recipe (combines mechanisms; no registry row of its own). Builds the product screens around `recipes/01-ai-assistant.md` (the... - [28 — Group utility: expense split on one shared card with personal panels](skills/telegram-bot-ui/recipes/28-group-expense-split.md): Product recipe (combines mechanisms; no registry row of its own). Uses 10.2-10.4 ephemeral replies (10.4 form: `callback_query_id`... - [29 — Community bot: join requests with rules, welcome, roles as visible tags](skills/telegram-bot-ui/recipes/29-community.md): Product recipe (combines mechanisms; no registry row of its own). Uses `chat_join_request` with `user_chat_id`, Rich Messages with... - [30 — News autoposter from a feed item](skills/telegram-bot-ui/recipes/30-news-autoposter.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [31 — Long read as one Rich Message](skills/telegram-bot-ui/recipes/31-long-read-rich-post.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [32 — Media album post (and paid media)](skills/telegram-bot-ui/recipes/32-media-album-post.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [33 — Poll and quiz posts in a channel](skills/telegram-bot-ui/recipes/33-poll-quiz-post.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [34 — Daily digest edited in place and pinned](skills/telegram-bot-ui/recipes/34-pinned-daily-digest.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [35 — Editorial approval before publishing](skills/telegram-bot-ui/recipes/35-editorial-approval.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [36 — Cross-posting to several channels and languages](skills/telegram-bot-ui/recipes/36-cross-post-variants.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [37 — Broadcast mailing with throttling and per-recipient outcomes](skills/telegram-bot-ui/recipes/37-broadcast-mailing.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [38 — Comment threads and channel direct messages](skills/telegram-bot-ui/recipes/38-comments-and-direct-messages.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [39 — Correcting a published post: edit or delete-and-repost](skills/telegram-bot-ui/recipes/39-correct-published-post.md): Registry rows: none (channel publishing combines existing methods; see `references/publishing-pipeline.md`). Verified 2026-11-15, Bot... - [40 — Deploy approval gate](skills/telegram-bot-ui/recipes/40-deploy-approval-gate.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [41 — Long build/test run with live status and a final report](skills/telegram-bot-ui/recipes/41-build-live-status.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [42 — Nightly job digest](skills/telegram-bot-ui/recipes/42-nightly-digest.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [43 — Ask the operator and continue](skills/telegram-bot-ui/recipes/43-ask-and-continue.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [44 — Streamed research answer with Stop](skills/telegram-bot-ui/recipes/44-streamed-research-stop.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [45 — Multi-job dashboard with private-chat topics](skills/telegram-bot-ui/recipes/45-multi-job-dashboard-topics.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [46 — The agent in a team group: personal replies](skills/telegram-bot-ui/recipes/46-team-group-personal-replies.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [47 — Incident alert with acknowledge and escalate](skills/telegram-bot-ui/recipes/47-incident-alert.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [48 — Coding-agent hooks call the bridge](skills/telegram-bot-ui/recipes/48-coding-agent-hooks.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [49 — Intake and security drill](skills/telegram-bot-ui/recipes/49-intake-security-drill.md): Agent-operated bot recipe; no changelog rows of its own (see `references/agent-operated-bots.md`). Verified 2026-11-15, Bot API 10.4. - [50 — Monitoring dashboard widget (private chat, production)](skills/telegram-bot-ui/recipes/50-monitoring-dashboard-widget.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [51 — Booking widget: day strip, time slots, confirm (private chat, production)](skills/telegram-bot-ui/recipes/51-booking-widget.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [52 — Shop: product card → cart → receipt (private chat, production)](skills/telegram-bot-ui/recipes/52-shop-card-to-checkout.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [53 — Quiz with a shared leaderboard (private chats + one shared widget, production)](skills/telegram-bot-ui/recipes/53-shared-quiz-leaderboard.md): Registry rows: `10.4-W02`, `10.4-W03`, `10.4-W04`, `10.4-W07`, `10.4-W08`, `10.4-W09` (`recipes/registry.json`). Checked 2026-11-15, Bot... - [54 — Long job progress in one card (private chat, production)](skills/telegram-bot-ui/recipes/54-job-progress-widget.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [55 — Design a new widget from a user's description (describe → widget workflow)](skills/telegram-bot-ui/recipes/55-design-a-widget.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [56 — API data browser: a widget as the front end of a REST backend (private chat, production)](skills/telegram-bot-ui/recipes/56-api-data-browser.md): Registry rows: `10.4-W02`, `10.4-W04`, `10.4-W07`, `10.4-W08` (`recipes/registry.json`). Checked 2026-11-15, Bot API 10.4. - [60 — Inline mode: share a place card into any chat, then let the chat vote on it](skills/telegram-bot-ui/recipes/60-inline-mode.md): Product recipe (combines mechanisms; no registry row of its own). Uses inline results with inline keyboards, `chosen_inline_result`,... - [61 — Business-account bot: auto-replies and quick replies on behalf of a bakery](skills/telegram-bot-ui/recipes/61-business-account.md): Product recipe (combines mechanisms; no registry row of its own). Uses `business_connection` / `business_message` updates,... - [62 — Monitoring and alerts bot: uptime and price watches, mute, quiet hours, daily digest](skills/telegram-bot-ui/recipes/62-monitoring-alerts.md): Product recipe (combines mechanisms; no registry row of its own). Uses `InlineKeyboardMarkup.force_reply` (10.3), disabled buttons and... - [63 — Search and long lists: a job board with filters, paging, detail and compare](skills/telegram-bot-ui/recipes/63-search-and-long-lists.md): Product recipe (combines mechanisms; no registry row of its own). Uses `InlineKeyboardMarkup.force_reply` (10.3), disabled buttons... - [64 — Delivery tracker: one status card per order, edited in place](skills/telegram-bot-ui/recipes/64-delivery-tracker.md): Product recipe (combines mechanisms; no registry row of its own). Uses `editMessageText`, regular-HTML `<tg-time>`, `10.3` disabled... - [70 — Restyle an existing bot from Unicode emoji to one premium pack](skills/telegram-bot-ui/recipes/70-restyle-to-premium.md): Registry rows: none of its own — Bot API 9.4 `icon_custom_emoji_id`, 6.2 custom emoji entities. Verified 2026-11-15, Bot API 10.4.... - [71 — Icons for a new bot from zero (no ids yet, capture path)](skills/telegram-bot-ui/recipes/71-icons-from-zero.md): Registry rows: none of its own — `MessageEntity.custom_emoji_id`, `getCustomEmojiStickers`, 9.4 button icons. Verified 2026-11-15, Bot... - [72 — Channel post series with premium accents and fallback](skills/telegram-bot-ui/recipes/72-channel-post-series.md): Registry rows: none of its own — custom emoji entities (6.2), RichTextCustomEmoji (10.3 rich messages). Verified 2026-11-15, Bot API... - [73 — Mixed eligibility: icons in private chats, Unicode in the channel](skills/telegram-bot-ui/recipes/73-mixed-eligibility.md): Registry rows: none of its own — 9.4 owner-Premium route. Verified 2026-11-15, Bot API 10.4. Background:... - [74 — Recover after the owner's Premium lapses](skills/telegram-bot-ui/recipes/74-premium-lapse.md): Registry rows: none of its own. Verified 2026-11-15, Bot API 10.4. Background:... - [75 — Migrate from one pack to another without touching handlers](skills/telegram-bot-ui/recipes/75-migrate-pack.md): Registry rows: none of its own. Verified 2026-11-15, Bot API 10.4. Background: `references/emoji-packs.md#migrating-to-another-pack`. - [80 — Lead intake with review and contact consent](skills/telegram-bot-ui/recipes/80-lead-intake.md): 1. **Request and visible result.** Collect a quote request and pass it to sales only after the user reviews it. - [81 — Event registration, waitlist and staff check-in](skills/telegram-bot-ui/recipes/81-event-waitlist.md): 1. **Request and visible result.** Register attendees up to capacity, then promote people from the waitlist when a place opens. - [82 — Personal reminders with rescheduling and cancellation](skills/telegram-bot-ui/recipes/82-personal-reminders.md): 1. **Request and visible result.** Let users save, move and cancel a reminder without an old queued job firing later. - [83 — File processing with cancellation and late-result protection](skills/telegram-bot-ui/recipes/83-file-processing.md): 1. **Request and visible result.** Summarize a PDF, show progress and let the user cancel without receiving a late result. - [84 — Moderation report review with scoped staff decisions](skills/telegram-bot-ui/recipes/84-moderation-review.md): 1. **Request and visible result.** Send a report to moderators; only staff of the correct group can decide on the current case. - [85 — Identified feedback with required answers and withdrawal](skills/telegram-bot-ui/recipes/85-feedback-survey.md): 1. **Request and visible result.** Ask for a rating, allow skipping the comment, and let the user withdraw their response. - [86 — Custom loyalty points with replay-safe earning and redemption](skills/telegram-bot-ui/recipes/86-loyalty-points.md): 1. **Request and visible result.** Credit points once per settled order and redeem a reward once per request. - [87 — Service queue with private tickets and staff advancement](skills/telegram-bot-ui/recipes/87-service-queue.md): 1. **Request and visible result.** Give each customer one place in a queue and let staff call one customer at a time. - [Recipe index](skills/telegram-bot-ui/recipes/README.md): Start by user intent: `python scripts/example_library.py --query "заявки CRM" --json` (from the skill root; catalog: `use-cases.json`).... - [Mini-recipes — specialized 10.3/10.4 modules](skills/telegram-bot-ui/recipes/mini-recipes.md): Registry rows: `10.4-W12`, `10.4-T03`, `10.4-S01`, `10.4-S02`, `10.4-S03`, `10.4-G01`, `10.4-G02`, `10.4-X01`, `10.4-X04`, `10.4-X05`,... - [manifest.json](skills/telegram-bot-ui/recipes/manifest.json): machine-readable index - [registry.json](skills/telegram-bot-ui/recipes/registry.json): machine-readable index - [use-cases.json](skills/telegram-bot-ui/recipes/use-cases.json): machine-readable index ## Tools - [audit_copy.py](skills/telegram-bot-ui/scripts/audit_copy.py): Audit a localized message catalog for interface consistency. Offline. - [audit_icons.py](skills/telegram-bot-ui/scripts/audit_icons.py): Audit a bot's icon system: one consistent custom-emoji family per bot. - [build_widget.py](skills/telegram-bot-ui/scripts/build_widget.py): Build a Telegram HTML widget (Bot API 10.4) from a source file and the widget kit. - [emoji_packs.py](skills/telegram-bot-ui/scripts/emoji_packs.py): Premium (custom) emoji packs for a bot: resolve, suggest, verify, capture, apply, strip. - [example_library.py](skills/telegram-bot-ui/scripts/example_library.py): Find examples by user intent and validate the use-case catalog offline. - [preview_widget.py](skills/telegram-bot-ui/scripts/preview_widget.py): Local preview of a Telegram HTML widget inside a MOCK of the widget runtime. - [style_profile.py](skills/telegram-bot-ui/scripts/style_profile.py): Research a bot project's style and check the bot's style profile. Offline, stdlib only. - [sync_bot_api.py](skills/telegram-bot-ui/scripts/sync_bot_api.py): Snapshot the whole Telegram Bot API into data/bot-api/ and diff it. - [tg_api_lookup.py](skills/telegram-bot-ui/scripts/tg_api_lookup.py): Offline lookup over the Bot API snapshot in data/bot-api/. - [tg_post.py](skills/telegram-bot-ui/scripts/tg_post.py): Validate, preview and publish a Telegram channel post described in JSON or Markdown. - [validate_keyboard.py](skills/telegram-bot-ui/scripts/validate_keyboard.py): Validate Telegram button payloads: inline, reply and rich-message buttons. - [validate_payload.py](skills/telegram-bot-ui/scripts/validate_payload.py): Structural check of Bot API requests (and objects) against data/bot-api/. - [validate_references.py](skills/telegram-bot-ui/scripts/validate_references.py): Validate the skill's internal references and links. - [validate_rich.py](skills/telegram-bot-ui/scripts/validate_rich.py): Check an InputRichMessage (or a sendRichMessage / draft payload) offline. - [validate_widget.py](skills/telegram-bot-ui/scripts/validate_widget.py): Check an HTML widget before sendWidget (Bot API 10.4). Offline, no token. - [widget_lint.py](skills/telegram-bot-ui/scripts/widget_lint.py): Strict widget checks for the gallery and for widgets an agent writes (Bot API 10.4, profile 1). ## Optional - [Activation eval scenarios](evals/activation-evals.md): Definitions only; these additions have not been run against an agent. - [Behavioral evals (reproducible, NOT yet run as agent evals)](evals/behavioral-evals.md): Full inputs and criteria are in `evals.json`. No agent run is recorded for these cases. - [Agent hosts: how each one finds and loads this skill](docs/hosts.md): This note drives the adapters in `adapters/`, the subagents in `agents/`, the plugin manifests in `.claude-plugin/` and... - [telegram-bot-ui: portable system prompt](adapters/portable/telegram-bot-ui.prompt.md): This is a single-file version of the telegram-bot-ui Agent Skill for agents that get only a system prompt and cannot open the skill's...
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

