# telegram

Hands your coding agent a Telegram CLI: read chats, search across them, reply, moderate groups and export history to files.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 476 installs · ★ 14
- Author: skillhq
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/skillhq/telegram/tree/HEAD/SKILL.md
- Updated: 2026-06-01
- HTML: https://affpapa.org/en/nevibecode/skills/telegram

## What it does

The skill installs a `telegram` command-line tool and tells the agent when to reach for it. Unread mail comes up with `telegram inbox`; `telegram chats` lists conversations and can filter by type. You can pull the last messages from one chat, or a DM by `@username` or numeric ID. Search runs inside a single chat or globally.

Sending covers DMs, group posts and replies to a specific message ID. Group management is there too: member and admin lists, promoting someone with a custom admin title, kicking a user, handing over ownership. Muting takes a duration or stays permanent, folders sort chats, and `telegram sync` writes history to markdown — add `--resume` and later runs fetch only what is new.

First-time setup needs API credentials from `https://my.telegram.org/apps` plus a login through `telegram auth`. Ownership transfer cannot be undone: you drop to a regular admin or member and only the new owner can hand it back. Telegram also blocks the transfer for about 24 hours after a fresh login and about 7 days after a two-step verification password change, and the command only accepts supergroups and channels.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add skillhq/telegram --skill telegram -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add skillhq/telegram --skill telegram -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add skillhq/telegram --skill telegram -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install skillhq/telegram telegram
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add skillhq/telegram --skill telegram -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/skillhq/telegram
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add skillhq/telegram --skill telegram -a opencode
```

### 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/skillhq/telegram/tree/HEAD/SKILL.md

## When to use it
- check unread Telegram messages without opening the app
- search every chat for a keyword at once
- reply to one specific message by its ID
- export a chat's history into markdown files
- unmute a work group or silence a noisy one

## Example prompts
- Show me my unread Telegram messages
- Search the “Project” chat for anything about the deadline this week
- Sync the last 30 days of chat history into `~/exports`

## Similar
- [access](https://affpapa.org/en/nevibecode/skills/access-2.md) — skill · 3867 installs
- [configure](https://affpapa.org/en/nevibecode/skills/configure-2.md) — skill · 3861 installs
- [claude-to-im](https://affpapa.org/en/nevibecode/skills/claude-to-im.md) — skill · 7100 installs
- [mode-creator](https://affpapa.org/en/nevibecode/skills/mode-creator.md) — skill · 1300 installs
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs
- [telegram-mini-app](https://affpapa.org/en/nevibecode/skills/sickn33-telegram-mini-app.md) — skill · 1700 installs

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