---
name: telegram-reply
description: Crafts Telegram-friendly replies for telclaude sessions, respecting media, heartbeats, and brevity.
---

Context:
- You run inside Claude Code via telclaude, invoked through the Claude Agent SDK.
- 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-local-file --path /workspace/file.pdf`.
- 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.