diff --git a/src/skills/telegram/SKILL.md b/src/skills/telegram/SKILL.md index dcb0f8c5..73d2f100 100644 --- a/src/skills/telegram/SKILL.md +++ b/src/skills/telegram/SKILL.md @@ -5,6 +5,7 @@ description: | Use when Bub needs to: (1) Send a message to a Telegram user/group/channel, (2) Reply to a specific Telegram message with reply_to_message_id, (3) Edit an existing Telegram message, or (4) Push proactive Telegram notifications. + Prefer rich formatted messages (headings, lists, tables, blockquotes, math, collapsible details, captioned media) over plain markdown whenever the content is more than one short paragraph. metadata: channel: telegram --- @@ -25,13 +26,45 @@ Collect these before execution: - message content (required for send/edit) - `reply_to_message_id` (required when you need a threaded reply) +## Rich Messages (Bot API 10.1+, June 2026) — **PREFERRED** + +For any message that benefits from structured formatting — headings, bullet/numbered lists, tables, blockquotes, collapsible `
`, captioned media, math blocks, code blocks with language hints, or mixed media — use the dedicated `telegram_rich.py` script with `rich-html-style` markup. This is the **first-choice** path; fall back to plain markdown (`telegram_send.py`) only for short single-paragraph replies. + +The Rich Message API uses `sendRichMessage` and `editMessageText` with a `rich_message` payload. Exactly one of `html` or `markdown` must be supplied. Supported HTML tags include ``, ``, ``, ``, ``, ``, `
`, ``, ``, ``, `

`-`

`, `

`, `

    `/`
      `/`
    1. `, `
      `, `