CtrlK
BlogDocsLog inGet started
Tessl Logo

telegram-automation

Automate Telegram tasks via Rube MCP (Composio): send messages, manage chats, share photos/documents, and handle bot commands. Always search tools first for current schemas.

71

1.68x
Quality

58%

Does it follow best practices?

Impact

91%

1.68x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/all-skills/skills/telegram-automation/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

67%

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 fairly strong with specific actions and a clear, distinctive niche around Telegram automation via Rube MCP. Its main weaknesses are the lack of an explicit 'Use when...' trigger clause and slightly limited coverage of natural user trigger terms. Adding explicit trigger guidance would meaningfully improve skill selection accuracy.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to send Telegram messages, interact with Telegram bots, or automate Telegram workflows.'

Include additional natural trigger terms users might say, such as 'Telegram bot', 'TG', 'post to Telegram', 'Telegram notification', or 'Telegram API'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'send messages, manage chats, share photos/documents, and handle bot commands.' Also includes the operational instruction to 'search tools first for current schemas.'

3 / 3

Completeness

Clearly answers 'what does this do' with specific actions, but lacks an explicit 'Use when...' clause. The when is only implied by the capability listing, which per the rubric caps completeness at 2.

2 / 3

Trigger Term Quality

Includes good keywords like 'Telegram', 'send messages', 'photos/documents', 'bot commands', but misses common user variations like 'Telegram bot', 'TG', 'chat message', 'Telegram API', or specific action terms users might say like 'post to Telegram' or 'Telegram notification'.

2 / 3

Distinctiveness Conflict Risk

Very distinct niche: Telegram automation via a specific MCP tool (Rube/Composio). The combination of 'Telegram' and 'Rube MCP (Composio)' makes it highly unlikely to conflict with other skills.

3 / 3

Total

10

/

12

Passed

Implementation

50%

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

This skill provides a comprehensive overview of Telegram automation via Rube MCP with good structural organization and useful tool sequences. Its main weaknesses are redundant information (pitfalls and limits repeated multiple times), lack of concrete executable examples showing actual MCP tool invocations, and missing validation/error-recovery steps in workflows. The content would benefit from deduplication, adding real call examples, and splitting detailed reference material into separate files.

Suggestions

Add concrete, executable MCP call examples showing actual RUBE_SEARCH_TOOLS and TELEGRAM_SEND_MESSAGE invocations with real parameter values instead of just listing parameter names.

Remove duplicated pitfalls and limits information—consolidate into the 'Known Pitfalls' section and reference it from individual workflows rather than repeating character limits, file size limits, etc.

Add validation/verification steps to core workflows, e.g., after TELEGRAM_SEND_MESSAGE check the returned message_id to confirm delivery, and include error handling guidance (what to do on 403 Forbidden, 429 rate limit, etc.).

Consider splitting the detailed per-workflow documentation and quick reference table into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with links.

DimensionReasoningScore

Conciseness

The skill is reasonably well-organized but contains significant redundancy—pitfalls are repeated across individual workflows and then again in a consolidated 'Known Pitfalls' section (e.g., 4096 char limit, 1024 caption limit, 50MB file limit appear multiple times). The quick reference table also duplicates information already covered in the workflows. Some content like explaining chat types is general Telegram knowledge Claude already possesses.

2 / 3

Actionability

The skill provides tool names, parameter lists, and tool sequences, which is helpful. However, there are no executable code examples or concrete MCP call examples showing actual invocation syntax with real parameters. The 'Common Patterns' section uses pseudocode-style numbered steps rather than actual executable calls. A user/Claude would need to call RUBE_SEARCH_TOOLS anyway to get schemas, making much of the parameter documentation potentially redundant or stale.

2 / 3

Workflow Clarity

Workflows are clearly sequenced with numbered steps and labeled as Required/Optional, which is good. However, there are no explicit validation checkpoints or error recovery feedback loops. For example, after sending a message, there's no step to verify delivery. The setup section has a basic verification flow but the core workflows lack 'if this fails, do X' guidance beyond the pitfalls lists.

2 / 3

Progressive Disclosure

The content is well-structured with clear sections and a useful quick reference table, but it's monolithic at ~180 lines with no references to supporting files. The detailed pitfalls, common patterns, and per-workflow documentation could be split into separate reference files. The single external link to Composio docs is helpful but the skill tries to be comprehensive in one file rather than layering information.

2 / 3

Total

8

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
davepoon/buildwithclaude
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.