Agent skill

Telegram Automation

by davepoon in davepoon/buildwithclaude

Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands.

MITAuto-check passedProductivity & Automation

Install Telegram Automation

skills CLI
$ npx skills add davepoon/buildwithclaude --skill telegram-automation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install davepoon/buildwithclaude telegram-automation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/davepoon/buildwithclaude.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/all-skills/skills/telegram-automation .claude/skills/telegram-automation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
telegram-automation
GitHub stars
3.6k
Used in
7 other repos
Token cost
~2.1k tokens
SKILL.md length
945 words
Files
1
Skills in repo
246
Repo updated
First seen
Licence
MIT

At a glance

Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands.

  • Works in 6 steps: Send Messages → Send Photos and Documents → Manage Chats → …
  • Tasks that involve App automation through connectors
  • SKILL.md covers Prerequisites, Setup, Core Workflows and Common Patterns, plus 2 more sections
  • Reaches rube.app

What it does

Telegram Automation is an agent skill from davepoon/buildwithclaude. Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering App automation through connectors and Messaging and chat bots. It works with Telegram and Composio. The repository describes itself as: A single hub to find Claude Skills, Agents, Commands, Hooks, Plugins, and Marketplace collections to extend Claude Code, Claude Desktop, Agent SDK and OpenClaw. The licence is MIT.

When your agent uses it

  • Tasks that involve App automation through connectors
  • Tasks that involve Messaging and chat bots

Example prompts

  • “/telegram-automation”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Send Messages
  2. Send Photos and Documents
  3. Manage Chats
  4. Edit and Delete Messages
  5. Forward Messages and Get Updates
  6. Manage Bot Commands

What it can do on your machine

Read from SKILL.md and the folder at commit 616deb5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • rube.app

    Also links to:

    • composio.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Telegram Automation loads about 2.1k tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 945 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from davepoon/buildwithclaude at commit 616deb5, republished under its MIT licence (© davepoon). 945 words, ~2,066 tokens.

Download SKILL.mdSave it as .claude/skills/telegram-automation/SKILL.md (or your agent's skills folder).
name
telegram-automation
description
Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas.
requires.mcp
rube
category
communication

Telegram Automation via Rube MCP

Automate Telegram operations through Composio's Telegram toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/telegram

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
  • Active Telegram connection via RUBE_MANAGE_CONNECTIONS with toolkit telegram
  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas
  • Telegram Bot Token required (created via @BotFather)

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

  1. Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
  2. Call RUBE_MANAGE_CONNECTIONS with toolkit telegram
  3. If connection is not ACTIVE, follow the returned auth link to configure the Telegram bot
  4. Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Send Messages

When to use: User wants to send text messages to a Telegram chat

Tool sequence:

  1. TELEGRAM_GET_ME - Verify bot identity and connection [Prerequisite]
  2. TELEGRAM_GET_CHAT - Get chat details and verify access [Optional]
  3. TELEGRAM_SEND_MESSAGE - Send a text message [Required]

Key parameters:

  • chat_id: Numeric chat ID or channel username (e.g., '@channelname')
  • text: Message text content
  • parse_mode: 'HTML' or 'MarkdownV2' for formatting
  • disable_notification: Send silently without notification sound
  • reply_to_message_id: Message ID to reply to

Pitfalls:

  • Bot must be a member of the chat/group to send messages
  • MarkdownV2 requires escaping special characters: _*[]()~>#+-=|{}.!
  • HTML mode supports limited tags: <b>, <i>, <code>, <pre>, <a>
  • Messages have a 4096 character limit; split longer content
2. Send Photos and Documents

When to use: User wants to share images or files in a Telegram chat

Tool sequence:

  1. TELEGRAM_SEND_PHOTO - Send an image [Optional]
  2. TELEGRAM_SEND_DOCUMENT - Send a file/document [Optional]

Key parameters:

  • chat_id: Target chat ID
  • photo: Photo URL or file_id (for SEND_PHOTO)
  • document: Document URL or file_id (for SEND_DOCUMENT)
  • caption: Optional caption for the media

Pitfalls:

  • Photo captions have a 1024 character limit
  • Document captions also have a 1024 character limit
  • Files up to 50MB can be sent via bot API
  • Photos are compressed by Telegram; use SEND_DOCUMENT for uncompressed images
3. Manage Chats

When to use: User wants to get chat information or manage chat settings

Tool sequence:

  1. TELEGRAM_GET_CHAT - Get detailed chat information [Required]
  2. TELEGRAM_GET_CHAT_ADMINISTRATORS - List chat admins [Optional]
  3. TELEGRAM_GET_CHAT_MEMBERS_COUNT - Get member count [Optional]
  4. TELEGRAM_EXPORT_CHAT_INVITE_LINK - Generate invite link [Optional]

Key parameters:

  • chat_id: Target chat ID or username

Pitfalls:

  • Bot must be an administrator to export invite links
  • GET_CHAT returns different fields for private chats vs groups vs channels
  • Member count may be approximate for very large groups
  • Admin list does not include regular members
4. Edit and Delete Messages

When to use: User wants to modify or remove previously sent messages

Tool sequence:

  1. TELEGRAM_EDIT_MESSAGE - Edit a sent message [Optional]
  2. TELEGRAM_DELETE_MESSAGE - Delete a message [Optional]

Key parameters:

  • chat_id: Chat where the message is located
  • message_id: ID of the message to edit or delete
  • text: New text content (for edit)

Pitfalls:

  • Bots can only edit their own messages
  • Messages can only be deleted within 48 hours of sending
  • In groups, bots with delete permissions can delete any message
  • Editing a message removes its 'edited' timestamp history
5. Forward Messages and Get Updates

When to use: User wants to forward messages or retrieve recent updates

Tool sequence:

  1. TELEGRAM_FORWARD_MESSAGE - Forward a message to another chat [Optional]
  2. TELEGRAM_GET_UPDATES - Get recent bot updates/messages [Optional]
  3. TELEGRAM_GET_CHAT_HISTORY - Get chat message history [Optional]

Key parameters:

  • from_chat_id: Source chat for forwarding
  • chat_id: Destination chat for forwarding
  • message_id: Message to forward
  • offset: Update offset for GET_UPDATES
  • limit: Number of updates to retrieve

Pitfalls:

  • Forwarded messages show the original sender attribution
  • GET_UPDATES returns a limited window of recent updates
  • Chat history access may be limited by bot permissions and chat type
  • Use offset to avoid processing the same update twice
Show full SKILL.md (333 more words)Show less
6. Manage Bot Commands

When to use: User wants to set or update bot command menu

Tool sequence:

  1. TELEGRAM_SET_MY_COMMANDS - Set the bot's command list [Required]
  2. TELEGRAM_ANSWER_CALLBACK_QUERY - Respond to inline button presses [Optional]

Key parameters:

  • commands: Array of command objects with command and description
  • callback_query_id: ID of the callback query to answer

Pitfalls:

  • Commands must start with '/' and be lowercase
  • Command descriptions have a 256 character limit
  • Callback queries must be answered within 10 seconds or they expire
  • Setting commands replaces the entire command list

Common Patterns

Chat ID Resolution

From username:

1. Use '@username' format as chat_id (for public channels/groups)
2. For private chats, numeric chat_id is required
3. Call GET_CHAT with username to retrieve numeric ID

From GET_UPDATES:

1. Call TELEGRAM_GET_UPDATES
2. Extract chat.id from message objects
3. Use numeric chat_id in subsequent calls
Message Formatting
  • Use parse_mode: 'HTML' for <b>bold</b>, <i>italic</i>, <code>code</code>
  • Use parse_mode: 'MarkdownV2' for *bold*, _italic_, `code`
  • Escape special chars in MarkdownV2: _ * [ ] ( ) ~ > # + - = | { } . !
  • Omit parse_mode for plain text without formatting

Known Pitfalls

Bot Permissions:

  • Bots must be added to groups/channels to interact
  • Admin permissions needed for: deleting messages, exporting invite links, managing members
  • Bots cannot initiate conversations; users must start them first

Rate Limits:

  • 30 messages per second to the same group
  • 20 messages per minute to the same user in groups
  • Bulk operations should implement delays between calls
  • API returns 429 Too Many Requests when limits are hit

Chat Types:

  • Private chat: One-on-one with the bot
  • Group: Multi-user chat (bot must be added)
  • Supergroup: Enhanced group with admin features
  • Channel: Broadcast-only (bot must be admin to post)

Message Limits:

  • Text messages: 4096 characters max
  • Captions: 1024 characters max
  • File uploads: 50MB max via bot API
  • Inline keyboard buttons: 8 per row

Quick Reference

TaskTool SlugKey Params
Verify botTELEGRAM_GET_ME(none)
Send messageTELEGRAM_SEND_MESSAGEchat_id, text, parse_mode
Send photoTELEGRAM_SEND_PHOTOchat_id, photo, caption
Send documentTELEGRAM_SEND_DOCUMENTchat_id, document, caption
Edit messageTELEGRAM_EDIT_MESSAGEchat_id, message_id, text
Delete messageTELEGRAM_DELETE_MESSAGEchat_id, message_id
Forward messageTELEGRAM_FORWARD_MESSAGEchat_id, from_chat_id, message_id
Get chat infoTELEGRAM_GET_CHATchat_id
Get chat adminsTELEGRAM_GET_CHAT_ADMINISTRATORSchat_id
Get member countTELEGRAM_GET_CHAT_MEMBERS_COUNTchat_id
Export invite linkTELEGRAM_EXPORT_CHAT_INVITE_LINKchat_id
Get updatesTELEGRAM_GET_UPDATESoffset, limit
Get chat historyTELEGRAM_GET_CHAT_HISTORYchat_id
Set bot commandsTELEGRAM_SET_MY_COMMANDScommands
Answer callbackTELEGRAM_ANSWER_CALLBACK_QUERYcallback_query_id

Powered by Composio

© davepoon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/all-skills/skills/telegram-automation of davepoon/buildwithclaude.

Open the folder on GitHubat commit 616deb5

Used in 7 other repositories

We found 16 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 7 other GitHub owners. This page covers the copy in davepoon/buildwithclaude, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Telegram Automation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Telegram Automation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Telegram Automation this skilldavepoon/buildwithclaude3.6k7 repos~2.1kAutomated safety check: PassMIT
Openloomi Connectorsmelandlabs/openloomi1k—~3.3kAutomated safety check: PassApache-2.0
Composioyc-software/qm15k—~1.6kAutomated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Abuselpdb AutomationComposioHQ/awesome-claude-skills77k3 repos~738Automated safety check: PassNone
Tlivey49/tlive215—~1.7kAutomated safety check: NotesMIT

Similar skills

  • Openloomi Connectors

    melandlabs/openloomi

    openloomi Connectors tools - manage the native 7 messaging integrations and pair with the composio skill for the 1000+ apps OAuth layer (Slack, Discord, X, Gmail, Outlook, Google…

    1k GitHub stars~3.3k tokensUpdated 15 days ago
    Productivity & AutomationAuto-check passed
  • Composio

    yc-software/qm

    Show the app connection picker or setup widget when users ask to connect apps, reopen setup, or need an app that isn't connected yet.

    15k GitHub stars~1.6k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Abuselpdb Automation

    ComposioHQ/awesome-claude-skills

    Automate Abuselpdb tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~738 tokens
    Productivity & AutomationAuto-check passed
  • Tlive

    y49/tlive

    tlive — remote approvals (Telegram/Feishu/web), live web terminal, and session monitoring for Claude Code / Codex.

    215 GitHub stars~1.7k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Easy Openclaw

    daheiai/easy-openclaw

    OpenClaw 配置优化向导。采用“第 0 层测试观测(可选)+ 前 3 轮优化 + 第 4 轮接入扩展”流程:基础推荐层(含联网搜索与权限模式)、渠道增强层(Discord/Feishu/Telegram 分支优化)、Skills 推荐层(可执行可跳过)、新增渠道接入引导(可跳过)。用于帮助用户快速完成 OpenClaw 初始化或优化配置。用户说到“优化…

    112 GitHub stars~1.7k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes

More from davepoon/buildwithclaude

All 246 skills in this repo
  • iOS Hig Design Guide

    davepoon/buildwithclaude

    Build, update, and apply iOS design specifications using Apple Human Interface Guidelines (HIG) source data.

    3.6k GitHub stars~735 tokensUpdated today
    Auto-check passed
  • Video Downloader

    davepoon/buildwithclaude

    Download YouTube videos with customizable quality and format options.

    3.6k GitHub starsUsed in 1 repo~871 tokens
    Auto-check passed
  • Qwen Vision

    davepoon/buildwithclaude

    A skill your agent uses when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare…

    3.6k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Atlas Cloud Media

    davepoon/buildwithclaude

    Discover Atlas Cloud image and video models, inspect their live schemas, and submit one confirmed media generation request with bounded GET polling.

    3.6k GitHub stars~852 tokensUpdated today
    Auto-check passed
  • Browser Extension Launch

    davepoon/buildwithclaude

    面向没有编程经验的用户,把想法做成可试用的浏览器插件,并完成检查、商店材料、审核提交和上线验证;也用于继续已有插件、排错和发布新版。用户说“帮我做个插件”“把插件上架”“继续我的插件”时使用。普通网站开发、仅查询插件知识不触发。

    3.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Slack Gif Creator

    davepoon/buildwithclaude

    Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives.

    3.6k GitHub starsUsed in 12 repos~4.3k tokens
    Auto-check passed

Questions about Telegram Automation

What does Telegram Automation do?

Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Telegram Automation is an agent skill from davepoon/buildwithclaude. Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands.

When should I use Telegram Automation?

Telegram Automation fits situations like: tasks that involve App automation through connectors; tasks that involve Messaging and chat bots.

How do I install Telegram Automation in Claude Code?

Run `npx skills add davepoon/buildwithclaude --skill telegram-automation -a claude-code`. Or copy the skill folder (plugins/all-skills/skills/telegram-automation in davepoon/buildwithclaude) into .claude/skills/telegram-automation in your project. Claude Code loads it when a task matches its description.

How do I install Telegram Automation in Codex?

Run `npx skills add davepoon/buildwithclaude --skill telegram-automation -a codex`. Or copy the skill folder (plugins/all-skills/skills/telegram-automation in davepoon/buildwithclaude) into .agents/skills/telegram-automation in your project. Codex loads it when a task matches its description.

Can I use Telegram Automation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add davepoon/buildwithclaude --skill telegram-automation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/telegram-automation, .gemini/skills/telegram-automation, .github/skills/telegram-automation and .opencode/skills/telegram-automation in your project.

What does Telegram Automation need to run?

SKILL.md names no scripts, command-line tools or credentials: Telegram Automation is instructions for the agent only.

Does Telegram Automation access the network?

SKILL.md names 2 domains. In commands or code: rube.app; the agent is likely to contact it when it follows the instructions. As links in the text: composio.dev. This is read from the text; nothing was executed.

Is Telegram Automation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Telegram Automation use?

Telegram Automation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Telegram Automation use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Telegram Automation?

Skills that share tags, products or a category with Telegram Automation: Openloomi Connectors (melandlabs/openloomi, 1k stars), Composio (yc-software/qm, 15k stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Abuselpdb Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Telegram Automation?

davepoon (a GitHub user) maintains it in davepoon/buildwithclaude, which has 3,605 GitHub stars. The repository holds 246 skills in this directory. The repository was last updated on October 9, 2026.

Source: davepoon/buildwithclaude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.