Agent skill

Telegram

by olasunkanmi-SE in olasunkanmi-SE/codebuddy

Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

MITAuto-check passedProductivity & Automation

Install Telegram

skills CLI
$ npx skills add olasunkanmi-SE/codebuddy --skill telegram -a claude-code

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

GitHub CLI
$ gh skill install olasunkanmi-SE/codebuddy telegram --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/olasunkanmi-SE/codebuddy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/telegram .claude/skills/telegram && 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
GitHub stars
141
Token cost
~817 tokens
SKILL.md length
203 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

  • Works in 3 steps: Create a bot via @BotFather on Telegram → Enter the bot token → Send /start to your bot to enable…
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Setup, Common Commands, Configuration Files and Security Notes, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Telegram is an agent skill from olasunkanmi-SE/codebuddy. Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

Its SKILL.md is about 820 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 Messaging and chat bots and Chatbots and conversational support. It works with Telegram. The repository describes itself as: An Autonomous AI Software Engineer. The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots
  • Tasks that involve Chatbots and conversational support

Example prompts

  • “/telegram”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Create a bot via @BotFather on Telegram
  2. Enter the bot token
  3. Send /start to your bot to enable messaging

What it can do on your machine

Read from SKILL.md and the folder at commit a9b8cd0. 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 (its code samples are bash).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • t.me

    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 loads about 817 tokens when it runs. Until then it costs about 26 tokens; SKILL.md has 203 words of instructions outside code blocks.

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

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 olasunkanmi-SE/codebuddy at commit a9b8cd0, republished under its MIT licence (© olasunkanmi-SE). 203 words, ~817 tokens.

Download SKILL.mdSave it as .claude/skills/telegram/SKILL.md (or your agent's skills folder).
name
telegram
description
Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.
metadata.displayName
Telegram
metadata.icon
send
metadata.category
communication
metadata.version
1.0.0

telegram-send

Use telegram-send to send messages, files, and media to Telegram chats. This tool requires initial configuration with a Telegram bot token.

Setup

Before using, configure telegram-send with your bot token:

bash
telegram-send --configure

This will prompt you to:

  1. Create a bot via @BotFather on Telegram
  2. Enter the bot token
  3. Send /start to your bot to enable messaging

For group chats, use --configure-group instead:

bash
telegram-send --configure-group

Common Commands

Send Text Message
bash
telegram-send "Hello from CodeBuddy!"
Send with Formatting
bash
# Markdown formatting
telegram-send --format markdown "**Bold** and _italic_ text"

# HTML formatting
telegram-send --format html "<b>Bold</b> and <i>italic</i> text"
Send Files
bash
# Send a document
telegram-send --file /path/to/document.pdf

# Send with caption
telegram-send --file /path/to/document.pdf --caption "Here's the report"
Send Images
bash
# Send image
telegram-send --image /path/to/image.png

# Send image with caption
telegram-send --image /path/to/screenshot.png --caption "Screenshot attached"
Send to Specific Config (Multiple Bots/Chats)
bash
# Use a specific config file
telegram-send --config /path/to/custom.conf "Message to specific chat"
Send Code Blocks
bash
# Send pre-formatted code
telegram-send --format markdown "\`\`\`python
def hello():
    print('Hello, World!')
\`\`\`"
Silent Messages (No Notification)
bash
telegram-send --silent "This won't trigger a notification"
Send Location
bash
telegram-send --location 37.7749 -122.4194

Configuration Files

Default config location: ~/.config/telegram-send.conf

You can have multiple configs for different bots/chats:

  • ~/.config/telegram-send.conf - default
  • ~/.config/telegram-send-group.conf - for group chats
  • Custom paths with --config

Security Notes

  • Bot tokens are stored in the config file - ensure proper file permissions
  • Run chmod 600 ~/.config/telegram-send.conf to secure credentials
  • Never commit config files to version control
  • Use separate bots for different purposes (personal, work, etc.)

Error Handling

If you get "Unauthorized" errors:

  1. Verify your bot token with @BotFather
  2. Ensure you've sent /start to the bot
  3. Re-run telegram-send --configure

Limitations

  • Can only send to users/groups that have started the bot
  • Rate limits apply (avoid spamming)
  • File size limits: 50MB for documents, 10MB for photos

© olasunkanmi-SE, 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 skills/telegram of olasunkanmi-SE/codebuddy.

Open the folder on GitHubat commit a9b8cd0

Compare with similar skills

Telegram 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Telegram this skillolasunkanmi-SE/codebuddy141—~817Automated safety check: PassMIT
Caspian Connect TelegramTryCaspian/caspian-sdk973—~446Automated safety check: NotesApache-2.0
Telegram BotOpenClaudia/openclaudia-skills711—~6kAutomated safety check: NotesMIT
Telegram Channel Setupanthropics/claude-plugins-official38k1 repos~1.1kAutomated safety check: NotesApache-2.0
Chat SDKdatabuddy-analytics/Databuddy1.2k—~2.6kAutomated safety check: PassAGPL-3.0
Telegrambubbuild/bub1.7k—~2.2kAutomated safety check: PassApache-2.0

Similar skills

  • Caspian Connect Telegram

    TryCaspian/caspian-sdk

    Connect Caspian Telegram for OpenCode, enable telegram in caspian.json channels, and tell the user to restart.

    973 GitHub stars~446 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes
  • Telegram Bot

    OpenClaudia/openclaudia-skills

    Send messages, images, and marketing content to Telegram channels and groups via Bot API.

    711 GitHub stars~6k tokensUpdated 20 days ago
    Productivity & AutomationAuto-check: notes
  • Telegram Channel Setup

    anthropics/claude-plugins-official

    Official

    Saves a Telegram bot token for the Telegram channel plugin and reviews who may message the bot, steering the policy toward a fixed allowlist.

    38k GitHub starsUsed in 1 repo~1.1k tokens
    Productivity & AutomationAuto-check: notes
  • Chat SDK

    databuddy-analytics/Databuddy

    Build multi-platform chat bots with Chat SDK (chat npm package).

    1.2k GitHub stars~2.6k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Telegram

    bubbuild/bub

    Telegram Bot skill for sending and editing Telegram messages via Bot API.

    1.7k GitHub stars~2.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Tlive

    y49/tlive

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

    214 GitHub starsUsed in 1 repo~1.7k tokens
    Productivity & AutomationAuto-check: notes

More from olasunkanmi-SE/codebuddy

All 10 skills in this repo
  • Datadog

    olasunkanmi-SE/codebuddy

    Query metrics, manage monitors, post events, and interact with Datadog via the dogshell CLI.

    141 GitHub stars~1.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Elasticsearch

    olasunkanmi-SE/codebuddy

    Interact with Elasticsearch clusters via the API. An agent skill from olasunkanmi-SE/codebuddy.

    141 GitHub stars~425 tokensUpdated 1 mo ago
    Auto-check passed
  • Gmail

    olasunkanmi-SE/codebuddy

    Read, send, and manage Gmail emails via the gmail-cli tool. An agent skill from olasunkanmi-SE/codebuddy.

    141 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check: warnings
  • GitHub

    olasunkanmi-SE/codebuddy

    Manage GitHub repositories, issues, and pull requests via the gh CLI.

    141 GitHub stars~611 tokensUpdated 1 mo ago
    Auto-check: notes
  • GitLab

    olasunkanmi-SE/codebuddy

    Manage GitLab issues and merge requests via the glab CLI. An agent skill from olasunkanmi-SE/codebuddy.

    141 GitHub stars~476 tokensUpdated 1 mo ago
    Auto-check: notes
  • Mysql

    olasunkanmi-SE/codebuddy

    Manage MySQL databases via the mysql CLI. An agent skill from olasunkanmi-SE/codebuddy.

    141 GitHub stars~399 tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Telegram

What does Telegram do?

Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool. Telegram is an agent skill from olasunkanmi-SE/codebuddy. Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

When should I use Telegram?

Telegram fits situations like: tasks that involve Messaging and chat bots; tasks that involve Chatbots and conversational support.

How do I install Telegram in Claude Code?

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

How do I install Telegram in Codex?

Run `npx skills add olasunkanmi-SE/codebuddy --skill telegram -a codex`. Or copy the skill folder (skills/telegram in olasunkanmi-SE/codebuddy) into .agents/skills/telegram in your project. Codex loads it when a task matches its description.

Can I use Telegram 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 olasunkanmi-SE/codebuddy --skill telegram -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, .gemini/skills/telegram, .github/skills/telegram and .opencode/skills/telegram in your project.

What does Telegram need to run?

SKILL.md names no scripts, command-line tools or credentials: Telegram is instructions for the agent only. Our summary lists: Python 3.

Does Telegram access the network?

SKILL.md names 1 domain. As links in the text: t.me. This is read from the text; nothing was executed.

Is Telegram 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 use?

Telegram 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 use?

About 817 tokens (SKILL.md is roughly 3.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?

Skills that share tags, products or a category with Telegram: Caspian Connect Telegram (TryCaspian/caspian-sdk, 973 stars), Telegram Bot (OpenClaudia/openclaudia-skills, 711 stars), Telegram Channel Setup (anthropics/claude-plugins-official, 38k stars) and Chat SDK (databuddy-analytics/Databuddy, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Telegram?

olasunkanmi-SE (a GitHub user) maintains it in olasunkanmi-SE/codebuddy, which has 141 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on August 28, 2026.

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