tao12345666333/telegram-sender
src/amcp/builtin_skills/telegram-sender/SKILL.md
Send and edit Telegram messages via Bot API. Use when AMCP needs to send a message, reply to a specific message, edit an existing message, or push proactive notifications (cron results, heartbeat alerts, task status). Requires AMCP_TELEGRAM_BOT_TOKEN env var.
$ install --global
skillsauthnpx skillsauth add tao12345666333/amcp telegram-senderInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 1, 2026, 6:08 AM389.6s2 files scanned
SKILL.md
- name:
- telegram-sender
- description:
- Send and edit Telegram messages via Bot API. Use when AMCP needs to send a message, reply to a specific message, edit an existing message, or push proactive notifications (cron results, heartbeat alerts, task status). Requires AMCP_TELEGRAM_BOT_TOKEN env var.
Telegram Sender
Agent-facing guide for outbound Telegram communication.
Assumption: AMCP_TELEGRAM_BOT_TOKEN is already set in the environment.
Required Inputs
chat_id(required) — from inbound message metadata or config- message content (required for send/edit)
reply_to_message_id(optional, for threaded reply)message_id(required for edit)
Execution Policy
- If handling a Telegram message and
message_idis known, prefer reply mode (--reply-to). - If source metadata says sender is a bot (
sender_is_bot=true), do not use reply mode; use--source-is-bot --source-username <USERNAME>instead. - For long-running tasks: send an acknowledgment first, then edit it with the final result.
- Keep content concise and action-oriented.
- Use literal newlines in message text.
Active Response Policy
When this skill is in scope, prefer proactive and timely Telegram updates:
- Send immediate acknowledgment for newly assigned tasks
- Send progress updates for long-running operations using message edits
- Send completion notifications when work finishes
- Send failure notifications immediately with cause, impact, and next action
Recommended pattern:
- Send a short acknowledgment reply
- Continue processing
- Edit the acknowledgment with final result (or send a new update if edit fails)
Command Templates
Paths are relative to this skill directory.
# Send message
python ./scripts/telegram_send.py send \
--chat-id <CHAT_ID> \
--message "<TEXT>"
# Reply to a specific message
python ./scripts/telegram_send.py send \
--chat-id <CHAT_ID> \
--message "<TEXT>" \
--reply-to <MESSAGE_ID>
# Bot-source: no direct reply, use @username style
python ./scripts/telegram_send.py send \
--chat-id <CHAT_ID> \
--message "<TEXT>" \
--source-is-bot \
--source-username <USERNAME>
# Edit existing message
python ./scripts/telegram_send.py edit \
--chat-id <CHAT_ID> \
--message-id <MESSAGE_ID> \
--text "<TEXT>"
For actions not covered by this script, use curl to call Telegram Bot API directly:
https://api.telegram.org/bot$AMCP_TELEGRAM_BOT_TOKEN/<method>
Script Reference
telegram_send.py send
--chat-id,-c: required--message,-m: required--reply-to,-r: optional message ID--token,-t: optional (normally not needed)--source-is-bot: optional flag--source-username: required when--source-is-botis set
telegram_send.py edit
--chat-id,-c: required--message-id,-i: required--text,-x: required--token,-t: optional (normally not needed)
Failure Handling
- On HTTP errors, inspect API response text and adjust identifiers/permissions.
- If edit fails (message not editable), fall back to a new send.
- If reply target is invalid, resend without
--reply-to. - For task-level failures, notify the user with what failed, what completed, and next steps.
Related Skills
tao12345666333/skill-creator
tools
VerifiedTrustedCommunity
Create or update AMCP skills. Use when designing, structuring, or packaging skills with scripts, references, and assets. This skill should be used when users want to create a new skill (or update an existing skill) that extends AMCP's capabilities with specialized knowledge, workflows, or tool integrations.
22SKILL.mdUpdated Apr 15, 2026
tao12345666333/session-cleanup
tools
VerifiedTrustedCommunity
Backup old AMCP sessions by renaming with execution date, then clean and compact sessions and memory.
22SKILL.mdUpdated Apr 15, 2026
tao12345666333/heartbeat
testing
VerifiedTrustedCommunity
Periodic heartbeat check that reads HEARTBEAT.md from the workspace and executes any tasks listed there. Use for autonomous background monitoring, periodic maintenance, and proactive task execution. Triggered by a cron schedule.
22SKILL.mdUpdated Apr 15, 2026
tao12345666333/context-management
tools
VerifiedTrustedCommunity
Learn how to manage conversation context in AMCP to avoid LLM API errors from exceeding context windows. This skill covers SmartCompactor strategies, token estimation, configuration, and best practices.
22SKILL.mdUpdated Apr 15, 2026