Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add makushingu/harness-maxxing --skill maxxing-telegram -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/maxxing-telegram/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/maxxing-telegram/

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.

Similar skills

All skills for Telegram bots →

From the same set21

The whole set →
maxxing-doctor The maxxing-doctor skill for Claude Code detects and resolves issues with Harness Maxxing installations. It activates when the UI fails to load, sessions hang, or automated tasks stop running. CX Codex +1 ★ 285repo stars maxxing-feed maxxing-feed is a Claude Code skill that routes events to the Harness Maxxing notification feed. It activates for requests to watch orders, email, deployments, or script results. CX Codex +1 ★ 285repo stars maxxing-cron The maxxing-cron skill for Claude Code automates shell commands or AI prompts on a schedule with Telegram reporting. It handles recurring tasks and future reminders. CX Codex +1 ★ 285repo stars maxxing-browser maxxing-browser is a Claude Code skill for configuring and troubleshooting Harness Browser. It activates for site sign-ins, form entry, page navigation, or browser access failures. CX Codex +1 ★ 285repo stars maxxing-infra maxxing-infra is a Claude Code skill that manages sites, databases, S3 buckets, and servers through Infra commands. It activates for hosting tasks and questions about resource locations or status. CX Codex +1 ★ 285repo stars maxxing-customize maxxing-customize is a Claude Code skill that customizes Harness Maxxing server logic and web interface across updates. Runs when adjusting internal rules or resolving update conflicts. CX Codex +1 ★ 285repo stars maxxing-extension maxxing-extension is a Claude Code skill that builds Harness Maxxing widgets, pages, and custom agent-overview views. It activates for requests to add or repair an extension in the interface. CX Codex +1 ★ 285repo stars maxxing-agents maxxing-agents is a Claude Code skill that builds and configures Harness Maxxing agents. It sets up persistent roles triggered by cron schedules, webhooks, or feed events under a daily budget. CX Codex +1 ★ 285repo stars

Project sponsors

Companies that keep this analytics open