SE

Lightweight Telegram notification sender for tasks and alerts without external dependencies.

Install

mkdir -p .claude/skills/send-message && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12093" && unzip -o skill.zip -d .claude/skills/send-message && rm skill.zip

Installs to .claude/skills/send-message

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Send a message to a Telegram chat via the Bot API directly. Self-contained — reads its own .env at the skill root and has no dependency on any Telegram plugin. Use when the user asks to push a Telegram notification to their phone, test the bot token, send from a hook or one-shot script, or 给 telegram 发消息 / 推送消息到手机. Push policy — default is NO push (terminal output is the notification); push ONLY for /loop or /schedule task results, explicit requests ("发给我" / "notify me"), or completion of long tasks (>5 min). Never push for routine replies, errors/permission prompts (hooks handle those), or intermediate progress. When unsure, don't push.
645 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • →Send Telegram messages for /loop or /schedule task results
  • →Send Telegram messages upon explicit user request
  • →Send Telegram messages for long-running task completion
  • →Send screenshots or file attachments via Telegram
  • →Test bot token functionality
  • →Send messages from hooks or one-shot scripts

How it works

The skill sends messages to the Telegram Bot API using `xh`, reading credentials from a local `.env` file. It supports sending text, files, and managing message options like chat ID and reply-to.

Inputs & outputs

You give it
A text message or a file path
You get back
A Telegram message sent to a specified chat

When to use send-message

  • →Notify when task finishes
  • →Send test message to Telegram
  • →Alert on loop results

About send-message

Posts messages to Telegram using the Bot API based on configurable rules. Prioritizes notifications for completed long-running tasks.

Send a message to a Telegram chat via the Bot API directly. Self-contained — reads its own .env at the skill root and has no dependency on any Telegram plugin. Use when the user asks to push a Telegram notification to their phone, test the bot token, send from a hook or one-shot script, or 给 telegra

When not to use it

  • →For routine replies or second-level tasks where results are in the terminal
  • →For error or permission requests handled by `hyprctl notify` hooks
  • →For intermediate progress updates unless explicitly requested

Prerequisites

TELEGRAM_BOT_TOKENTELEGRAM_DEFAULT_CHAT_IDxhjq

Limitations

  • →Refuses to attach any file inside the skill directory
  • →50 MB attachment cap
  • →Send-only; cannot receive messages

How it compares

This skill is a self-contained Telegram sender that uses its own `.env` for credentials and posts directly to the API, unlike relying on a Telegram MCP plugin.

Compared to similar skills

send-message side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
send-message (this skill)03moCautionBeginner
gmail-manager275moReviewIntermediate
mailchimp-automation25moNo flagsIntermediate
action-creator210moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry