hlibsuslov/telegram-bot-ui
v2.2.1MIT
Design, build, review and operate Telegram bots with the newest Bot API: bot screens and keyboards, streaming AI replies, HTML widgets, premium emoji, product flows, channel publishing, agent-operated bots and Bot API lookups. Bundles the telegram-bot-ui skill and five subagents.
Changelog
Versions follow Semantic Versioning. The version lives in
adapters/routing.json (generated into .claude-plugin/plugin.json) and in the
metadata.version of skills/telegram-bot-ui/SKILL.md; scripts/validate_skill.py fails if they differ.
Each release is tagged v<version>.
2.2.1 - 2026-11-15
PRIVACY.md, linked from the plugin manifests together with a support URL.- Directory edition:
scripts/build_directory_edition.pybuilds a documentation-only copy of the plugin (skill, references, recipes, JSON Bot API catalog, Claude subagents; no scripts or runnable examples) and.github/workflows/directory-edition.ymlpublishes it to theclaude-directorybranch for the Claude plugin directory.
2.2.0 - 2026-11-15
- Widget kit:
K.askno longer locks the widget whenrequest()throwsTypeErrorsynchronously (empty or > 64-byte data); regression test runs the kit in Node. - Widget checks: canvas pixel access, patterns, shadows and compositing; SVG
clipPath,mask,pattern,marker,foreignObject, SMIL and<image>; logical properties, multi-column,display: contents/flow-root,background-clip: text,writing-mode. Strict lint warns onrequestfrompointerdown, state written withinnerHTML, and canvas arcs past 2π.media-carouselusedmargin-inline-end(out of profile 1) and now uses physical margins. - Widget docs: bot-side lifecycle for long jobs, editor with autostart, image shrink loop,
canvas cut-outs, UI strings in
public_data, the two-crash rule; raw exception text and logurudiagnoseas bot-token leaks inerrors-and-fallbacks.md. - Widget checks also flag removed form elements (
datalist,output, …),meta,ruby,math, legacy presentational tags and attributes, editing/focus attributes,popoveranddata:AVIF/BMP/ICO images; thedisabled-pseudowarning is gone (profile 1 maps:disabledto[disabled]on<button>). - SDK status: aiogram 3.32.0 and node-telegram-bot-api 2.4.0 ship the widget methods; Telegram's widget-sandbox listed as an official source.
2.1.0 - 2026-11-15
- Deep redesign path (
skills/telegram-bot-ui/references/redesign-orchestration.md): access and mandate levels, project style research, brand mapped onto what Telegram allows, a new menu structure with a migration for oldcallback_data, commands and deep links, and a tuning loop. - Bot style profile (
skills/telegram-bot-ui/references/bot-style-profile.md): the knobs that tune a bot, each with its evidence.scripts/style_profile.pyprobes a project's style signals without opening secrets, scaffolds a profile and checks it against API limits and the skill's rules. - README (en, ru, uk): plugin icon and name above the banner, release and stars badges, install
with the GitHub CLI (
gh skill install hlibsuslov/telegram-bot-ui);docs/assets/social-preview.pngfor the repository's link preview.
2.0.1 - 2026-11-15
- Plugin icon:
assets/icon.svg(Codexinterface.composerIcon) and a 512 pxassets/icon.png(Claude Code pluginicon, Codexinterface.logo), wired in byscripts/build_adapters.py.
2.0.0 - 2026-11-15
First tagged release of telegram-bot-ui, the successor of the telegram-rich-messages
skill.
- Bot UI/UX skill for Bot API 10.4: screens, keyboards, colored buttons, streaming AI replies with Stop, private replies in groups, Rich Messages, HTML widgets, custom emoji packs, formatting and localization.
- Product recipes (shop, support, booking, onboarding, subscriptions, inline mode, business), channel publishing with approval, and agent-operated bots with a security core.
- Offline Bot API catalog and lookup, payload, keyboard, rich message and widget validators.
- Packaging: the skill lives in
skills/telegram-bot-ui/(the folder installers copy, with its ownLICENSE); Claude Code plugin and marketplace, an Agent Pluginsplugin.json, a Codex.codex-plugin/plugin.json, five subagents, Codex agents, and adapters for Cursor, Gemini CLI, Copilot and plainAGENTS.md, all generated from the skill'sSKILL.mdandadapters/routing.json.