| 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"
python "$SKILL_DIR/scripts/tg_send.py" message "Message text"
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"
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)
