25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
---
|
|
name: telegram-photo
|
|
description: Use when Codex should send, show, or share a local picture into the Telegram chat through the bot without calling Telegram tools.
|
|
metadata:
|
|
short-description: Send Telegram photos from assistant output
|
|
---
|
|
|
|
# Telegram Photo
|
|
|
|
When asked to send/show/share a picture in Telegram, emit a photo directive in normal assistant output. The bot strips the directive and sends the image as a Telegram photo.
|
|
|
|
Use exactly one directive line per image, outside code fences:
|
|
|
|
`<!-- telegram-photo {"path":"<absolute-local-image-path>","caption":"<optional caption>"} -->`
|
|
|
|
Rules:
|
|
- Replace `<absolute-local-image-path>` with an absolute path that the bot container can read.
|
|
- The source image may live anywhere on the host, but the bot runs in Docker; before emitting the directive, make sure the image is inside a workspace under the configured playground base directory or another path explicitly mounted into the bot container.
|
|
- If the image is outside container-visible paths, copy it into an appropriate workspace-local location first, then use the copied file's absolute path in the directive.
|
|
- Do not hardcode machine-specific directories, user names, repository paths, or sample filenames in this skill.
|
|
- Supported extensions are `.jpg`, `.jpeg`, `.png`, `.webp`, and `.gif`.
|
|
- `caption` is optional and should be short; omit the `caption` field when no caption is needed.
|
|
- Do not use external Telegram tool calls for this.
|
|
- If no usable container-visible image path is known, ask for the path or explain what local file is needed.
|