maxxing-telegram — Claude Code skill: what it does, how to install
maxxing-telegram is a Claude Code skill that configures the Harness Maxxing Telegram gateway. It handles bot linking, session modes, mobile inputs, and server alerts.
no license ★ 285 updated 2026-11-17
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a claude-codeWhat maxxing-telegram does
The skill sets up a direct Telegram bridge without running an external bot daemon. It supports three operating modes: simple using replies in a single chat, threads mapping each open session to a forum topic, and mirror which reflects web UI actions silently into Telegram threads.
The bridge relays health warnings, two-step sign-ins, failed scheduled runs, and agent authorization prompts. Sending voice notes, photos, or documents attaches them directly to the active session topic with automatic transcription for voice.
Initial configuration requires a token from BotFather and pairing through a one-time link valid for 15 minutes. The wizard writes the token to secrets.json. If another service holds a webhook or polls the bot simultaneously, Telegram returns 409 conflict until the competing process stops.
What it helps with
- connect Harness Maxxing to a dedicated Telegram bot
- switch between single-chat replies and forum thread modes
- feed voice notes and files directly into session contexts
- receive system health alerts and approve agent actions remotely
- resolve webhook conflicts and poller errors
Example prompts for the agent
- Guide me through linking a new Telegram bot via BotFather
- Why does maxxing telegram report a 409 conflict error?
- Switch the Telegram bridge mode to simple and check status
How to install maxxing-telegram
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a claude-code2Manually: put the files in place
~/.claude/skills/maxxing-telegram/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/maxxing-telegram/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a codex2Manually: put the files in place
.agents/skills/maxxing-telegram/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a cursor2Manually: put the files in place
.cursor/skills/maxxing-telegram/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install makushingu/harness-maxxing skills/maxxing-telegram2Manually: put the files in place
.github/skills/maxxing-telegram/SKILL.md1Skills CLI (Vercel)
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a gemini-cli2Platform CLI
gemini skills install https://github.com/makushingu/harness-maxxing --path skills/maxxing-telegramManually: put the files in place
.devin/skills/maxxing-telegram/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about maxxing-telegram
How to install maxxing-telegram in Claude Code?
Run npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a claude-code. The skill definition will be placed in ~/.claude/skills/maxxing-telegram/SKILL.md.
What does maxxing-telegram do?
It assists with setting up, switching modes, and debugging the built-in Harness Maxxing Telegram gateway.
What is required to run the Telegram bridge?
You need a bot token from @BotFather and an account paired via a temporary 15-minute link. The token is kept securely in secrets.json.