telegram-reply
Crafts Telegram-friendly replies for telclaude sessions, respecting media, heartbeats, and brevity.
Security Assessment
About telegram-reply
The `telegram-reply` skill is designed to craft concise, Telegram-compatible responses within telclaude sessions, directly addressing the challenges of handling media-rich messages while maintaining clarity and brevity. Operating inside Claude Code via the Claude Agent SDK, it processes incoming Telegram messages that may include media attachments such as voice notes or images. This skill ensures that replies remain practical for Telegram's character limits, efficiently summarizing long outputs and saving extensive content to files instead of sending bulky inline messages. It also maintains security best practices by avoiding the disclosure of secrets or environment variables unless explicitly provided by the user.
Key features of this skill include context-aware responses, media protocol alignment, and efficient file handling. For messages accompanied by transcripts, it uses the context to generate relevant replies. When dealing with files, it provides terse diffs or bullet-point summaries rather than sending full file contents inline, and it clearly reports the paths of files it reads or writes. Media handling is precise: voice messages are responded to with voice, images are considered for visual replies, and simultaneous text and voice outputs are avoided. Additionally, the skill provides commands to send attachments from external providers or local workspace files directly to Telegram, confirming successful delivery to the user.
This skill is particularly useful for developers, technical support agents, and anyone managing automated Telegram interactions that require intelligent handling of media and files. It is suitable for scenarios such as summarizing lengthy transcripts, delivering concise code reviews, sharing documents, or responding to user queries with multimedia content. Target users are those who need a reliable tool for generating Telegram-ready outputs while respecting platform constraints and maintaining workflow efficiency, including those in software development, customer support, and information management contexts.
FAQ
How does telegram-reply handle long messages?
It summarizes long outputs and saves them to files rather than sending large inline messages, keeping replies within Telegram's practical limit of approximately 1500 characters.
Can this skill send files to users?
Yes, it can send both external attachments using `telclaude send-attachment --ref <attachment.ref>` and local workspace files using `telclaude send-local-file --path /workspace/file.pdf`, confirming delivery with a success message.
How are voice messages handled?
Incoming voice messages are responded to with voice messages only, following the protocol that a human would not speak and write simultaneously.
Are there any permission requirements?
Tool access is controlled by the host-defined permission tier, which can be READ_ONLY, WRITE_LOCAL, or FULL_ACCESS.
Does telegram-reply expose secrets or environment variables?
No, it never echoes secrets or environment variables unless the user explicitly provides them in the same message.
Install telegram-reply
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
avivsinai/telclaude