Tlgr

Read and act on a personal Telegram account from the terminal with the tlgr CLI (MTProto user account, not a bot). Use when the user wants to check unread Telegram chats, read or search message history, send, reply to, edit, forward or schedule messages, manage chats, groups, channels, contacts, folders, reactions, polls, media or stories, or receive Telegram events through a webhook. Every command answers in JSON with stable exit codes.

199 stars 3 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)

npx skills add tlgrcli/tlgr --skill tlgr

Manual install

git clone --depth 1 https://github.com/tlgrcli/tlgr.git /tmp/tlgr
mkdir -p ~/.claude/skills
cp -r /tmp/tlgr/plugin/skills/tlgr ~/.claude/skills/tlgr

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# tlgr: Telegram for agents

`tlgr` controls a real Telegram user account over MTProto through a local
daemon. Everything you can do in a Telegram app, you can do from a shell:
messages, chats, groups, channels, contacts, media, stories, polls and more.
The full reference is `AGENT.md` in the repository, and `tlgr schema --json`
describes every command, flag and response.

## Install and check

```bash
pipx install tlgr-cli          # the command is `tlgr`
tlgr agent whoami --json       # active account, daemon health, schema version
tlgr status --check            # non-zero exit when anything is wrong
```

The daemon starts itself on first use. If `whoami` reports no account, go to
**Logging in**.

## Rules that matter

1. **Always pass `--json`.** Errors are JSON on stdout too, and the exit code
   is the contract. `--results-only` strips the envelope and `--select a,b.c`
   projects fields.
2. **Reading can be visible.** `chat open` sends a read receipt the other side
   sees and clears the owner's unread badge. To look without a trace use
   `chat catchup`, `message list` or `chat open --no-read`. A read receipt
   cannot be taken back; `chat unread` only restores the owner's badge.
3. **Name the account when there is more than one.** Pass `-a <alias>` so a
   message never goes out from the wrong identity.
4. **Secrets never go in argv.** Use `--password-env`, `--api-hash-env`,
   `--token-env` and friends, or their `-stdin` and `-file` forms.

Read the full skill on GitHub

Details

Skill name: tlgr
Repository: tlgrcli/tlgr
Path: plugin/skills/tlgr/SKILL.md
License: MIT
Repo updated: 28 October 2026
Listed in: karanb192/awesome-claude-skills

FAQ

What does the Tlgr skill do?

How do I install the Tlgr skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add tlgrcli/tlgr --skill tlgr. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Tlgr popular?

It lives in tlgrcli/tlgr, which has 199 GitHub stars and 3 forks, and is included in 1 curated skill list.

Related skills

Superior Trade Auth

218

Superior-Trade/superior-skills

Use when an agent needs to register a Superior Trade account, verify an email OTP, configure x-api-key authentication, or recover from missing or invalid credentials before using the Unified API.

Software Development

Review Forge

224

vikingmute/review-forge

Use when orchestrating a code review workflow across multiple LLMs or agents, synthesizing review findings, producing checklist-driven fix scopes, applying selected fixes, running regression tests, independently verifying fixes, updating review status, or keeping code review process artifacts isolated under code_review/.

Software Development11

Design Doc Mermaid

179

SpillwaveSolutions/design-doc-mermaid

Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code. Default for GitHub wiki. Use when asked to create a diagram, generate mermaid, document architecture, or convert code to diagram. PlantUML is only for leftover types. Confluence needs PNG/SVG as well as the fence.

Software Development24

Observe Whatsapp

195

gokapso/agent-skills

Observe and troubleshoot WhatsApp in Kapso: search Logs across API, Meta webhook, workflow, and webhook-delivery events; debug message delivery; inspect webhook retries; triage API errors; and run health checks. Use when investigating production issues, message failures, workflow behavior, or webhook delivery problems.

Software DevelopmentIn 1 list27

Software Certificate Skill

173

IvanCodesDev/software-certificate-skill

面向普通用户，从真实软件项目全自动生成中国软件著作权申请资料：一次收集登记事实，自动分析业务、选择可追溯源码、取得真实界面证据，生成申请表信息、规范黑白灰操作手册、代码前后30页或全部材料及真实 DOCX/PDF；内部验证、渲染、哈希与备份只进入系统临时运行区，项目最终仅保留正式资料。适配 Codex、Claude Code、Cursor、OpenCode、WorkBuddy、QoderWork、TraeWork 及支持 Agent Skills 或 AGENTS.md 的平台。用户提到软件著作权、软著申请资料、申请表、代码材料、操作手册或软著审查时使用。

Software Development12

Backend Interview Simulator

232

Hazehacker/backend-interview-simulator

Use when users want to practice or simulate Java, C++, Go, Golang, mixed-stack, or general backend technical interviews, including resume-based and job-description-based interview preparation.

Software Development11

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.