Menu
Owner-only Telegram text bridge and Mini App gateway for the existing Ouroboros interface.
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/razzant/ouroboros --skill telegramThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
Based on SOC occupation classification
| name | telegram |
| description | Owner-only Telegram text bridge and Mini App gateway for the existing Ouroboros interface. |
| version | 1.0.1 |
| type | extension |
| entry | plugin.py |
| runtime | python3 |
| os | any |
| permissions | ["net","read_settings","widget","route","supervised_task","subscribe_event","inject_chat","subprocess","companion_process"] |
| env_from_settings | ["TELEGRAM_BOT_TOKEN"] |
| subscribe_events | ["chat.outbound","chat.typing","chat.photo","chat.video","chat.document"] |
| conflicts | ["telegram-bridge","telegram-miniapp-poc"] |
| when_to_use | The owner wants to communicate with and control Ouroboros through Telegram. |
| timeout_sec | 60 |
| companion_processes | [{"name":"miniapp_gateway","command":["python3","scripts/companion.py"],"runtime":"python3","restart_policy":"on_failure","max_restarts":5}] |
One owner-only Telegram integration provides both the established bot bridge and the optional Mini App. The first positive private Telegram chat binds as the sole owner. Text and photos can be sent to Ouroboros; replies, photos, videos, documents, typing state, subagent cards, and opt-in notifications are mirrored back to that owner.
The Mini App exposes the unchanged Ouroboros SPA through the established owner-authenticated sidecar and a pinned Cloudflare Quick Tunnel. It is enabled by default after owner binding and can be turned off independently without stopping the text bridge. Disabling the skill destroys process-memory Mini App sessions, stops public exposure, and best-effort restores the prior Telegram menu button. Rotate the bot token only while the skill is disabled, then re-enable it.
Set TELEGRAM_BOT_TOKEN in Settings, grant it to this skill, enable the skill,
and send the bot a private message to bind the owner. No legacy Telegram skill
state is copied or changed. Installations that use telegram-bridge or
telegram-miniapp-poc must disable or remove those skills before enabling this
one.
The Mini App supports macOS arm64/x86_64, Linux arm64/x86_64, and Windows x86_64. Only the explicit unsupported OS/architecture case degrades independently: the text bridge remains available while Mini App status reports that no pinned cloudflared asset exists. Invalid host runtime, unsafe state, or companion registration errors fail the skill load instead of claiming a partial healthy installation.
The Mini App is Beta. Its best-effort Cloudflare Quick Tunnel has no SLA and does not support Server-Sent Events (SSE). It targets native Telegram clients; Telegram WebA/WebK are not supported.