telegram-cli-sender - SKILL.md Agent Skill

name: telegram-cli-sender description: Enviar mensajes y media por Telegram Bot API usando la CLI local `tgbot` del repo `My_Telegram_API`, incluyendo gestion de agenda de chat IDs por alias. Usar cuando se necesite enviar texto, MarkdownV2, HTML, fotos, videos, audios, documentos, ubicaciones, encuestas o acciones de chat desde terminal, incluyendo casos con archivos locales, URLs o file_id.

Telegram CLI Sender

Overview

Operar Telegram Bot API mediante tgbot en lugar de construir requests HTTP manuales. Resolver tareas de envio y operaciones base (get-me, get-updates, send-chat-action) con comandos reproducibles.

Workflow

Validar credenciales:

Confirmar TELEGRAM_BOT_TOKEN o usar --token.
Confirmar destino con --chat-id, --chat-alias, TELEGRAM_CHAT_ID o alias default de agenda.

Gestionar agenda cuando aplique:

Guardar alias con tgbot agenda add --name <alias> --chat-id <id> --default.
Listar alias con tgbot agenda list.

Elegir comando tgbot por tipo de contenido:

Texto: send-message.
Media: send-photo, send-video, send-audio, send-document, send-animation, send-voice, send-video-note.
Otros: send-location, send-venue, send-contact, send-poll, send-dice, send-chat-action.

Seleccionar formato de mensaje cuando aplique:

--parse-mode MarkdownV2 con escapes correctos.
--parse-mode HTML con entidades y tags validos.

Resolver media:

Ruta local existente: upload multipart automatico.
URL HTTP/HTTPS o file_id: envio como referencia.

Para payloads complejos:

Usar campos JSON inline o archivo (@archivo.json) en flags JSON.
Para send-media-group/send-paid-media, usar --media-json o --media-file y --attach nombre=ruta cuando haya attach://nombre.

Usar --json cuando la salida deba consumirse por otro script o automatizacion.

Rules

Priorizar get-updates para descubrir chat_id en configuraciones nuevas.
Priorizar alias de agenda para evitar hardcodear chat IDs en comandos repetitivos.
No inventar escapes MarkdownV2: aplicar reglas de escape al contenido real.
Si hay error 400 por parametros, corregir payload y reintentar; no asumir que el token fallo.
Si hay error 401, verificar token antes de cualquier otro ajuste.

Command Reference

Usar ejemplos listos en references/commands.md.