CtrlK
BlogDocsLog inGet started
Tessl Logo

add-telegram

Add Telegram as a channel. Can replace WhatsApp entirely or run alongside it. Also configurable as a control-only channel (triggers actions) or passive channel (receives notifications only).

64

Quality

75%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/add-telegram/SKILL.md
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.

The content is a highly actionable, well-sequenced multi-phase setup guide with executable commands, explicit validation gates, and error-recovery feedback loops, kept lean with only minor trims possible.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — it never explains what git, npm, or Telegram are — with only minor sentences that could be trimmed (e.g., the generic merge-conflict advice), matching the 'efficient; minor instances of over-explanation' anchor. Not 5 because a few explanatory sentences are not strictly necessary; not 3 because padding is minimal.

4 / 5

Actionability

Provides copy-paste-ready commands throughout (git remote/fetch/merge, npm install/build, vitest, env sync, register with explicit flags) covering both main and trigger-only chats plus macOS/Linux variants, matching the 'fully executable; copy-paste ready; covers common cases' anchor. Not 4 because virtually every step has concrete executable commands with no real gaps.

5 / 5

Workflow Clarity

Sequenced into clear phases with an explicit validation gate ('All tests must pass... before proceeding'), an inline merge-conflict feedback loop, a dedicated Verify phase, and a Troubleshooting recovery section, matching the 'clear sequence with explicit validation; feedback loops for error recovery' anchor. The destructive-op cap does not apply because validation is present.

5 / 5

Progressive Disclosure

Well-organized into clear phase and section headers with content appropriately placed inline as a cohesive walkthrough and no external references needed, matching 'good structure; most content appropriately placed; minor organization gaps'. Not 5 because at ~150 lines it exceeds the simple-skill exception and puts everything inline with no overview-to-detail split; not 3 because it is well structured, not a disorganized inline dump.

4 / 5

Total

18

/

20

Passed

Description

62%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.

The description is specific and clearly niched to Telegram, with several concrete configuration modes, but lacks an explicit 'Use when...' trigger clause and omits natural terms like 'Telegram bot' that users would say.

Suggestions

Add an explicit 'Use when...' trigger clause (e.g., 'Use when the user wants to add Telegram as a messaging channel or replace WhatsApp with Telegram.') to raise completeness above 3.

Include natural trigger terms users actually say, such as 'Telegram bot' or 'bot token', to improve trigger-term coverage.

Optionally list the concrete actions performed (install channel code, configure bot token, register chat) alongside the configuration modes to push specificity toward 5.

DimensionReasoningScore

Specificity

Names several concrete capabilities ('replace WhatsApp entirely or run alongside it', 'control-only channel (triggers actions)', 'passive channel (receives notifications only)'), matching the 'several specific actions; minor gaps' anchor. Not 5 because these are configuration modes rather than a comprehensive list of distinct concrete actions; not 3 because more than 1-2 concrete capabilities are named.

4 / 5

Completeness

Clearly states what the skill does (add Telegram channel with configurable modes) but has no 'Use when...' trigger guidance, so completeness is capped at 3 per the judging guidelines. Not 4 because no explicit 'when' clause is present.

3 / 5

Trigger Term Quality

Contains natural terms ('Add Telegram', 'Telegram', 'WhatsApp', 'channel') but misses common variations a user might say such as 'Telegram bot' or 'bot token', fitting the 'some relevant keywords but missing common variations' anchor. Not 4 because it lacks the broader multi-term coverage of that anchor's example.

3 / 5

Distinctiveness Conflict Risk

Targets a clear Telegram-specific niche ('Add Telegram as a channel') with minimal overlap risk against other skills, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor. Not 4 because it is more narrowly scoped than the 'PDF and Word' overlap example.

5 / 5

Total

15

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jbaruch/nanoclaw-telegram
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.