# telegram-bot-cloudflare

The telegram-bot-cloudflare Claude Code skill guides Telegram bot deployment on Cloudflare Workers and secret setup. It activates for requests to create, deploy, or fix a bot on Workers.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 326 repo stars
- Author: mrhlaingbwardev
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mrhlaingbwardev/agentic-hacking-skills/tree/HEAD/skills/telegram-bot-cloudflare/SKILL.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/telegram-bot-cloudflare

## What it does

The skill walks through configuring a `workers.dev` subdomain, deploying a Worker script, storing the bot token as a secret, and setting the webhook. It also covers checking webhook status and common failures, including a missing subdomain or an SSL certificate that is still pending. The sample uses plain JavaScript and Telegram API requests, with no external imports.

Deployment requires a bot token from `@BotFather`, a Cloudflare account with Workers enabled, and a configured `workers.dev` subdomain. Cloudflare MCP is used to make Cloudflare API requests. The Worker cannot be deployed before the subdomain is configured; secret values should be checked in the dashboard for the `Value encrypted` issue.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill telegram-bot-cloudflare -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/telegram-bot-cloudflare/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/telegram-bot-cloudflare/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill telegram-bot-cloudflare -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/telegram-bot-cloudflare/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill telegram-bot-cloudflare -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/telegram-bot-cloudflare/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mrhlaingbwardev/agentic-hacking-skills skills/telegram-bot-cloudflare
```

2. **Manually: put the files in place**
- File: `.github/skills/telegram-bot-cloudflare/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill telegram-bot-cloudflare -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mrhlaingbwardev/agentic-hacking-skills --path skills/telegram-bot-cloudflare
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/telegram-bot-cloudflare/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mrhlaingbwardev/agentic-hacking-skills/tree/HEAD/skills/telegram-bot-cloudflare/SKILL.md

## When to use it
- deploy a Telegram bot to Cloudflare Workers
- store the bot token as a Worker secret
- connect a Telegram webhook to the Worker URL
- diagnose a bot that fails to respond

## Example prompts
- Deploy my Telegram bot to Cloudflare Workers and set its webhook.
- Fix the `BOT_TOKEN` secret for my bot on Cloudflare Workers.
- Find out why my Telegram bot on Cloudflare Workers is not responding.

## Similar
- [cloudflare-email-telegram-cursorrules-prompt-file](https://affpapa.org/en/nevibecode/rules/cloudflare-email-telegram-cursorrules-prompt-file.md) — rule · ★ 41178 repo stars
- [telegram-bot](https://affpapa.org/en/nevibecode/skills/telegram-bot.md) — skill · 6500 installs
- [telegram-bot-builder](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-bot-builder.md) — skill · 3800 installs
- [telegram-group-analytics-bot](https://affpapa.org/en/nevibecode/skills/telegram-group-analytics-bot.md) — skill · 615 installs
- [telegram-group-statistics-analytics-bot](https://affpapa.org/en/nevibecode/skills/telegram-group-statistics-analytics-bot.md) — skill · 610 installs
- [cloudflare](https://affpapa.org/en/nevibecode/skills/cloudflare-cloudflare.md) — skill · 159200 installs

From the same set: [mrhlaingbwardev/agentic-hacking-skills](https://affpapa.org/en/nevibecode/by/mrhlaingbwardev/agentic-hacking-skills.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
