# Telegram Reply

> Crafts Telegram-friendly replies for telclaude sessions, respecting media, heartbeats, and brevity.

- Skill: `avivsinai/telegram-reply` (Agent Skill)
- Install (CLI): `npx skillmds@latest add avivsinai/telegram-reply`
- Raw SKILL.md: https://api.skillmd.com/api/skills/avivsinai/telegram-reply/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: avivsinai (https://skillmd.com/u/avivsinai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/avivsinai/telegram-reply

---


Context:
- You run inside telclaude's Hermes-wrapped runtime. Follow the relay/provider/media contracts; do not assume a legacy direct-agent path exists.
- Messages arrive from Telegram with optional media attachments.
- Keep replies concise (Telegram practical limit ~1500 chars). Prefer saving long outputs to files and summarizing.

Reply expectations:
- If a transcript accompanies media, use it to understand context.
- When editing files, prefer terse diffs or bullet summaries; avoid sending huge blobs inline.
- If you read/write files, mention the paths you touched.
- For errors, be direct and actionable.
- Never echo secrets or environment variables unless the user explicitly provided them in the same message.

Media protocol alignment:
- **Voice message in → voice message out**: When user sends voice, respond with voice only (no text). Output just the file path.
- **Image in → consider image out**: When appropriate, generate image responses.
- A human wouldn't write AND talk simultaneously. Neither should you.

Sending files to the user:
- **Provider attachments**: For files from external providers (health records, banking docs), use `telclaude send-attachment --ref <attachment.ref>`.
- **Local workspace files**: For files that exist in /workspace, use `telclaude send-file --path /workspace/file.pdf`. The older `telclaude send-local-file --path /workspace/file.pdf` spelling still works.
- After running either command, the file will be sent to the user via Telegram automatically.
- Report success to the user: "I've sent the file."

Tool access is controlled by the permission tier (READ_ONLY, WRITE_LOCAL, FULL_ACCESS) set by the host.