Install and configure the Telegram Skill Bot. An agent skill from terranc/claude-telegram-bot-bridge.

No licenceAuto-check: notesProductivity & Automation

Install Setup

skills CLI
$ npx skills add terranc/claude-telegram-bot-bridge --skill setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install terranc/claude-telegram-bot-bridge setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/terranc/claude-telegram-bot-bridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/setup .claude/skills/setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup
GitHub stars
134
Token cost
~1.5k tokens
SKILL.md length
691 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Install and configure the Telegram Skill Bot. An agent skill from terranc/claude-telegram-bot-bridge.

  • Works in 9 steps: Detect Language → Check System Requirements → Get Telegram Bot Token → …
  • Users ask to install
  • SKILL.md covers What this skill does, Usage, Implementation and Error Handling, plus 2 more sections
  • Calls python3, pip and brew; needs OPENAI_API_KEY and TELEGRAM_BOT_TOKEN

What it does

Setup is an agent skill from terranc/claude-telegram-bot-bridge. Install and configure the Telegram Skill Bot. Use when users ask to install, set up, or configure the bot. Supports multi-language installation guidance (English, Chinese, Japanese, Spanish, French, German). Handles system requirement checks, bot token collection, user whitelist configuration, proxy setup, virtual environment creation, dependency installation, and .env file generation.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Chatbots and conversational support. It works with Telegram and Python. The repository describes itself as: A lightweight Telegram bot that bridges Claude Code to any local folder, with autostart support for remote mobile development.

When your agent uses it

  • Users ask to install
  • Configure the bot

Example prompts

  • “/setup”

Requirements

  • Python 3
  • Node.js
  • A credential in TELEGRAM_BOT_TOKEN
  • A credential in OPENAI_API_KEY

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Detect Language
  2. Check System Requirements
  3. Get Telegram Bot Token
  4. Optional Configuration
  5. Create Virtual Environment
  6. Install Dependencies
  7. Save Configuration
  8. Optional Voice Message Support
  9. Completion

What it can do on your machine

Read from SKILL.md and the folder at commit b6e82be. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3
    • pip
    • brew
    • claude
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • python.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OPENAI_API_KEY
    • TELEGRAM_BOT_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup loads about 1.5k tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 691 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:3
    t creation, dependency installation, and .env file generation.
  • NoteMentions a .env fileSKILL.md:20
    6. Saves configuration to .env file
  • NoteMentions a .env fileSKILL.md:100
    Create `.env` file based on `.env.example` template with the collected information:
  • NoteMentions a .env fileSKILL.md:111
    The generated `.env` should maintain the same structure and comments as `.env.example`, only activating the options the
  • NoteMentions a .env fileSKILL.md:125
    ses to enable voice support, update the `.env` file by uncommenting and setting these variables:
  • NoteMentions a .env fileSKILL.md:129
    guration options are already present in `.env` as commented defaults from Step 7.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 691 words (~1,506 tokens).

“This skill guides users through installing the Telegram Skill Bot in their preferred language.”

— opening of SKILL.md by terranc
name
setup
allow_tools
Read, Bash(md5 *)

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/setup of terranc/claude-telegram-bot-bridge.

Open the folder on GitHubat commit b6e82be

Compare with similar skills

Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup this skillterranc/claude-telegram-bot-bridge134—~1.5kAutomated safety check: NotesNone
Pytdbotpytdbot/client137—~4.3kAutomated safety check: PassMIT
Telegrambubbuild/bub1.7k—~2.2kAutomated safety check: PassApache-2.0
Telegram Bot Builderaiskillstore/marketplace4303 repos~2.2kAutomated safety check: NotesNone
Add Telegram API Testsvendelieu/telegram-bot249—~609Automated safety check: NotesApache-2.0
Add Wizard Handlervendelieu/telegram-bot249—~508Automated safety check: PassApache-2.0

Similar skills

  • Pytdbot

    pytdbot/client

    Write Telegram bots and userbots with Pytdbot (async TDLib wrapper with high-level helpers; not the Telegram Bot API).

    137 GitHub stars~4.3k tokensUpdated 10 days ago
    Productivity & AutomationAuto-check passed
  • Telegram

    bubbuild/bub

    Telegram Bot skill for sending and editing Telegram messages via Bot API.

    1.7k GitHub stars~2.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Telegram Bot Builder

    aiskillstore/marketplace

    Expert in building Telegram bots that solve real problems - from simple automation to complex AI-powered bots.

    430 GitHub starsUsed in 3 repos~2.2k tokens
    Productivity & AutomationAuto-check: notes
  • Add Telegram API Tests

    vendelieu/telegram-bot

    Writes tests for Telegram Bot API actions. An agent skill from vendelieu/telegram-bot.

    249 GitHub stars~609 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check: notes
  • Add Wizard Handler

    vendelieu/telegram-bot

    Configures @WizardHandler annotation for wizard flows. An agent skill from vendelieu/telegram-bot.

    249 GitHub stars~508 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Add Wizard Step

    vendelieu/telegram-bot

    Implements WizardStep for wizard flows. An agent skill from vendelieu/telegram-bot.

    249 GitHub stars~634 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed

Works with

Questions about Setup

What does Setup do?

Install and configure the Telegram Skill Bot. An agent skill from terranc/claude-telegram-bot-bridge. Setup is an agent skill from terranc/claude-telegram-bot-bridge. Install and configure the Telegram Skill Bot.

When should I use Setup?

Setup fits situations like: users ask to install; configure the bot.

How do I install Setup in Claude Code?

Run `npx skills add terranc/claude-telegram-bot-bridge --skill setup -a claude-code`. Or copy the skill folder (.claude/skills/setup in terranc/claude-telegram-bot-bridge) into .claude/skills/setup in your project. Claude Code loads it when a task matches its description.

How do I install Setup in Codex?

Run `npx skills add terranc/claude-telegram-bot-bridge --skill setup -a codex`. Or copy the skill folder (.claude/skills/setup in terranc/claude-telegram-bot-bridge) into .agents/skills/setup in your project. Codex loads it when a task matches its description.

Can I use Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add terranc/claude-telegram-bot-bridge --skill setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup, .gemini/skills/setup, .github/skills/setup and .opencode/skills/setup in your project.

What does Setup need to run?

Going by SKILL.md and its folder, Setup needs the command-line tools its instructions call (python3, pip, brew, claude and npm) and credentials named OPENAI_API_KEY and TELEGRAM_BOT_TOKEN. Our summary lists: Python 3; Node.js; A credential in TELEGRAM_BOT_TOKEN; A credential in OPENAI_API_KEY.

Does Setup access the network?

SKILL.md names 1 domain. As links in the text: python.org. This is read from the text; nothing was executed.

Is Setup safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Setup use?

No licence was found for Setup or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Setup use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup?

Skills that share tags, products or a category with Setup: Pytdbot (pytdbot/client, 137 stars), Telegram (bubbuild/bub, 1.7k stars), Telegram Bot Builder (aiskillstore/marketplace, 430 stars) and Add Telegram API Tests (vendelieu/telegram-bot, 249 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup?

terranc (a GitHub user) maintains it in terranc/claude-telegram-bot-bridge, which has 134 GitHub stars. The repository was last updated on May 30, 2026.

Source: terranc/claude-telegram-bot-bridge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.