telegram-notify

name	telegram-notify
description	Send Telegram messages, files, and images with a bundled Python script. Use when you need to notify users or deliver generated artifacts outside the chat session.

Telegram Notify

Overview

This skill provides a simple way to send messages, files, and images to a Telegram chat using a bot. It includes a Python script that reads credentials from a local environment file and supports Markdown formatting in messages. Use it to notify users, deliver reports, or share outputs from your agent workflows.

Description

Send messages and files to a Telegram chat using a bot.

When to use it

• When you need to notify someone outside the current session
• When you need to send a generated file (PDF, Excel, PPTX, image, and so on)
• When a job or cron task produces output that should be delivered via Telegram
• When something requires urgent attention

How to use it

Use only the bundled script scripts/tg_send.py. Do not use manual curl calls.

SKILL_DIR=".agents/skills/telegram-notify"

# Send a text message
python "$SKILL_DIR/scripts/tg_send.py" message "Message text"

# Send a file (PDF, PPTX, Excel, zip, and so on)
python "$SKILL_DIR/scripts/tg_send.py" file "/path/to/file.pdf"
python "$SKILL_DIR/scripts/tg_send.py" file "/path/to/file.pdf" --caption "Here is the report"

# Send an image
python "$SKILL_DIR/scripts/tg_send.py" image "/path/to/image.png"
python "$SKILL_DIR/scripts/tg_send.py" image "/path/to/image.png" --caption "Screenshot"

Important notes

• The script discovers credentials automatically from scripts/TELEGRAM.env
• Messages support Markdown: bold, italic, code, link
• Maximum message length is 4096 characters; split long messages if needed
• Check output for OK: Sent successfully
• No external libraries are required; only Python 3 standard library

File structure

telegram-notify/
|-- SKILL.md
`-- scripts/
    |-- tg_send.py
    |-- TELEGRAM.env.example
    `-- TELEGRAM.env (local only, never publish)