Tooluck logoTooluck
SKILL.md

telegram-reader

Agent skill fromhimself65/finance-skills

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.

How to install telegram-reader

install telegram-reader
# install the finance-skills pack with the skills CLI
npx skills add himself65/finance-skills

# or add only this skill to Claude Code: copy the folder

plugins/social-readers/skills/telegram-reader/

# into

~/.claude/skills/telegram-reader/ (all projects)

.claude/skills/telegram-reader/ (one project)

plugins/social-readers/skills/telegram-reader/SKILL.md

MITFull file
1# Telegram News Skill (Read-Only)
2
3If 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.
4
5Reads Telegram channels and groups for financial news and market research using [tdl](https://github.com/iyear/tdl), a Telegram CLI tool.
6
7**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.
8
9---
10
11## Step 1: Ensure tdl Is Installed
12
13**Current environment status:**
14
15```
16!`(command -v tdl && tdl version 2>&1 | head -3 || echo "TDL_NOT_INSTALLED") 2>/dev/null`
17```
18
19If the status above shows a version number, tdl is installed — skip to Step 2.
20
21If `TDL_NOT_INSTALLED`, install tdl based on the user's platform:
22
23| Platform | Install Command |
24|----------|----------------|
25| macOS / Linux | `curl -sSL https://docs.iyear.me/tdl/install.sh \| sudo bash` |
26| macOS (Homebrew) | `brew install telegram-downloader` |
27| Linux (Termux) | `pkg install tdl` |
28| Linux (AUR) | `yay -S tdl` |
29| Linux (Nix) | `nix-env -iA nixos.tdl` |
30| Go (any platform) | `go install github.com/iyear/tdl@latest` |
31…

Excerpt shown under the repository's MIT license.

More skills in finance-skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates