telegram-skills

telegram-skills

Agent Skills for Telegram Bot API 10.1 Rich Messages — works with Claude Code, Codex CLI, Cursor, and any agent supporting the Agent Skills standard (agentskills.io). Teach your AI agent to send structured documents, tables, galleries, maps, and streaming AI replies from any Telegram bot.

Bot API 10.1 (June 11, 2026) introduced Rich Messages: bots can now send document-grade structured messages (section headings, tables, collapsible sections, photo collages, slideshows, maps, math) and stream AI-generated replies with a native "thinking" block — essentially Instant View articles, right in the chat.

No major bot library supports it yet. These skills work through raw HTTP calls to the Bot API — no dependencies, any stack.

Install

Universal (recommended)

npx skills add serejaris/telegram-skills

# Install a single skill
npx skills add serejaris/telegram-skills --skill tg-rich-messages

Claude Code (native marketplace)

/plugin marketplace add serejaris/telegram-skills
/plugin install telegram-skills@telegram-skills

Codex CLI

npx skills add serejaris/telegram-skills
# or manually: cp -r skills/* ~/.agents/skills/
# Inside a clone of this repo, skills are auto-discovered via .agents/skills/

Manual copy

# Claude Code
cp -r skills/* ~/.claude/skills/

# Codex CLI / other agents
cp -r skills/* ~/.agents/skills/

# or per-project
cp -r skills/* your-project/.claude/skills/
cp -r skills/* your-project/.agents/skills/

Then ask your agent — e.g. "send this report to my Telegram channel as a rich message".

Skills

Skill	What it does
tg-rich-messages	Core reference: all block & inline types, JSON structure, limits and traps, raw HTTP sending
tg-markdown-to-rich	Convert Markdown into a rich message — write docs, send documents
tg-rich-streaming	Stream LLM output into a chat: draft animation, thinking block, mandatory finalization
tg-rich-digest	Digest/report pattern: headings, lists, collapsible sections, photo collage, map embed

Reference

• reference/rich-messages-spec.md — full extracted spec: every type, every field, all limits (Bot API 10.1)
• Official: Bot API docs · changelog · demo bot @RichTextDemoBot

License

MIT