Agent skill · writing content · himself65
telegram-reader
Read Telegram channels and groups for financial news and market research with the tdl CLI: list chats and channels, find a channel by name, and export recent messages or a date or ID range. Use this skill whenever the user wants to check their Telegram, see what's new in their channels, read or export messages from a news, crypto, or trading channel or group, or gather market news and signals posted on Telegram. Read-only: it cannot send messages or join or leave channels.
Why this skill is useful
Provides specific commands and workflows for extracting financial news from Telegram channels that the AI wouldn't reliably generate on its own.
What it needs
Requires tdl installed locally. About 5k tokens when loaded. Last updated 2026-08-05. 3,127 stars on the source repository.
What this skill does
Telegram News Skill (Read-Only) If your host has not already executed the shell probes below (for example, in Codex), run the commands inside the ! wrappers with its shell tool before choosing a setup path. Use the actual output; if shell access is unavailable, report that limitation. Reads Telegram channels and groups for financial news and market research using tdl, a Telegram CLI tool. This skill is read-only. It is designed for financial research: reading channel messages, monitoring financial news channels, and exporting message history. It does NOT support sending messages, joining/leaving channels, or any write operations. --- Step 1: Ensure tdl Is Installed Current environment status: If the status above shows a version number, tdl is installed — skip to Step 2. If TDLNOTINSTALLED, install tdl based on the user's platform: Platform Install Command ---------- ---------------- macOS / Linux curl -sSL https://docs.iyear.me/tdl/install.sh \ sudo bash macOS (Homebrew) brew install telegram-downloader Linux (Termux) pkg install tdl Linux (AUR) yay -S tdl Linux (Nix) nix-env -iA nixos.tdl Go (any platform) go install github.com/iyear/tdl@latest Default to Homebrew on macOS. On Linux the install script runs with sudo, so confirm with the user before using it, or offer their package manager instead. --- Step 2: Ensure tdl Is Authenticated Current auth status: If AUTHOK, skip to Step 3. If AUTHNEEDED, guide the user through login. Login requires interactive input — the user must enter their phone number and verification code manually. Login methods Method A: QR Code (recommended — fastest) A QR code will be displayed in the terminal. The user scans it with their Telegram mobile app (Settings > Devices > Link Desktop Device). Method B: Phone + Code The user enters their phone number, then the verification code sent to their Telegram app. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills himself65/telegram-reader