CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-executed operational skill: fully executable commands, explicit auth/install validation checkpoints, and a clearly signaled, real reference file. The only blemishes are host-specific shell-probe/Codex scaffolding noise and some detail that duplicates the reference file.

Suggestions

Remove or generalize the host-specific paragraph about `!` shell wrappers and "Codex", and the "Current environment status" probe blocks — they are harness noise that costs tokens for most users.

Move the chat-identifier formats table and per-method login detail into references/commands.md, keeping only a pointer and the recommended login method in the body to reduce duplication.

DimensionReasoningScore

Conciseness

The body is mostly lean — command tables, copy-paste examples, and terse key rules — with only minor trimmable content: the host-specific `!` shell-probe wrapper paragraph (mentioning Codex), the "Current environment status" probe blocks, and repeated read-only statements. Not score 3 because nothing explains concepts Claude already knows; not score 5 because the probe/Codex material is off-topic noise that does not earn its tokens.

4 / 5

Actionability

Fully executable, copy-paste-ready commands cover the common cases: `tdl chat ls -o json`, `-f "VisibleName contains 'Bloomberg'"`, `tdl chat export -c @channel_name -T last -i 20 --all --with-content -o /tmp/tdl-export.json`, plus a concrete error/fix diagnostics table. This matches the 5 anchor.

5 / 5

Workflow Clarity

A clear 6-step sequence (install → auth → identify → execute → present → diagnose) with explicit validation checkpoints — install probe, `tdl chat ls --limit 1` auth check before other commands, start-small rule — and feedback loops for error recovery (FLOOD_WAIT wait-and-retry, re-auth on session errors). Read-only skill, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Good structure: the body is a readable overview and the one-level-deep reference `references/commands.md` (verified to exist and well-organized) is clearly signaled with its purpose and when to read it. Minor gap: chat-identifier formats and login-method detail partially duplicate the reference and could live there, keeping it below 5.

4 / 5

Total

18

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person voice, concrete capability list, an explicit "Use this skill whenever..." trigger clause with natural user phrasings, and a clear read-only boundary. Minor room to improve by mentioning topic/thread exports and a few more user-side synonyms.

DimensionReasoningScore

Specificity

Lists several concrete actions — "list chats and channels, find a channel by name, and export recent messages or a date or ID range" — with only minor gaps (topic/thread export is not mentioned). It is above score 3 because it covers more than 1-2 actions, but below score 5 because coverage is not fully comprehensive.

4 / 5

Completeness

Clearly answers both questions: the first sentence states what the skill does, and "Use this skill whenever the user wants to check their Telegram, see what's new in their channels..." provides explicit, concrete trigger phrases. This matches the 5 anchor exactly.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "check their Telegram", "see what's new in their channels", "read or export messages from a news, crypto, or trading channel or group", "market news and signals". A few natural variations (e.g., "catch up on my Telegram", "monitor a channel") are missing, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche — reading Telegram channels/groups via the tdl CLI for financial news — with distinct triggers and an explicit read-only boundary ("it cannot send messages or join or leave channels"), so conflict risk with other skills is minimal.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

himself65/finance-skills

Path

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

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.