CtrlK
BlogDocsLog inGet started
Tessl Logo

telegram

Telegram integration. Manage data, records, and automate workflows. Use when the user wants to interact with Telegram data.

48

Quality

51%

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 ./skills/telegram/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

61%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 body is well-structured and action-packed with executable CLI commands and a strong connection-state workflow, but it has some duplicated content and lacks verification steps around running actions.

Suggestions

De-duplicate the action-list command, which appears nearly identically in 'Searching for actions' and 'Popular actions'.

Add a validation or verify step after running actions (e.g., inspecting the output field or checking action state) since action runs and proxy requests can be destructive or batch operations.

Trim padded explanatory prose such as 'so you can focus on the integration logic rather than auth plumbing' that restates what the commands already show.

DimensionReasoningScore

Conciseness

Mostly efficient with executable commands throughout, but the 'Searching for actions' and 'Popular actions' sections duplicate the same action-list command and there is minor padded prose around Membrane auth.

3 / 5

Actionability

Provides concrete, copy-paste-ready bash commands with --json flags and real parameter forms for install, auth, connection, action list, action run, and proxy requests; only minor gaps such as no concrete Telegram actionId example.

4 / 5

Workflow Clarity

The connection flow has a clear install-auth-connect sequence with state polling and feedback loops, but running actions and proxy requests lack validation/verification steps for what could be destructive or batch operations, capping clarity at 3.

3 / 5

Progressive Disclosure

Single-file skill with well-organized section headers and no nested or broken references; the proxy flag table and best practices are appropriately placed with only minor organization gaps.

4 / 5

Total

14

/

20

Passed

Description

41%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 includes an explicit trigger clause and is Telegram-specific, but its capability claims are generic ('manage data, records, and automate workflows') rather than concrete Telegram actions.

Suggestions

Replace generic verbs with concrete Telegram actions, e.g. 'Send messages, manage chats, and control bots via Telegram'.

Add natural trigger phrases users actually say, such as 'Telegram messages', 'Telegram bot', or 'send a Telegram message'.

Tighten the 'what' so it pairs with the existing 'Use when' clause to clearly answer both what the skill does and when to invoke it.

DimensionReasoningScore

Specificity

Names the Telegram domain but the actions listed ('Manage data, records, and automate workflows') are generic with no concrete Telegram-specific operations such as sending messages or managing chats.

2 / 5

Completeness

Both a 'what' and an explicit 'Use when' clause are present, but the 'what' ('Manage data, records, and automate workflows') is too vague to push above the midpoint.

3 / 5

Trigger Term Quality

Keywords are essentially the brand name 'Telegram' plus generic 'data'; common natural phrases users say ('send a message', 'Telegram bot', 'chat') are missing.

2 / 5

Distinctiveness Conflict Risk

The Telegram brand and 'interact with Telegram data' trigger make it mostly distinct with only minor overlap risk from the generic data-management phrasing.

4 / 5

Total

11

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
membranedev/application-skills
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.