Agent skill

telegram

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

View SKILL.md on GitHub Repository
Stars 118
Forks 34

Install this agent skill to your Project

npx add-skill https://github.com/olasunkanmi-SE/codebuddy/tree/main/skills/telegram

Metadata

Additional technical details for this skill

auth 
{
    "type": "bot-token",
    "setupCommand": "telegram-send --configure"
}
icon
send
config 
[
    {
        "name": "TELEGRAM_CONFIG",
        "type": "string",
        "label": "Config Path",
        "required": false,
        "placeholder": "~/.config/telegram-send.conf"
    }
]
version
1.0.0
category
communication
displayName
Telegram
dependencies 
{
    "cli": "telegram-send",
    "install": {
        "linux": {
            "pip": "telegram-send"
        },
        "darwin": {
            "pip": "telegram-send"
        },
        "windows": {
            "pip": "telegram-send"
        }
    },
    "checkCommand": "telegram-send --version"
}

SKILL.md

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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

olasunkanmi-SE/codebuddy

email

Send emails using mailsend-go CLI

118 34
Explore
olasunkanmi-SE/codebuddy

aws

Manage AWS resources via the aws CLI.

118 34
Explore
olasunkanmi-SE/codebuddy

redis

Manage Redis databases via the redis-cli tool.

118 34
Explore
olasunkanmi-SE/codebuddy

datadog

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

118 34
Explore
olasunkanmi-SE/codebuddy

linear

Manage Linear issues via the linear-cli (unofficial or custom wrapper).

118 34
Explore
olasunkanmi-SE/codebuddy

gitlab

Manage GitLab issues and merge requests via the glab CLI.

118 34
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results