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
58%
Does it follow best practices?
Impact
91%
1.68xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/all-skills/skills/telegram-automation/SKILL.mdQuality
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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
d065ead
Table of Contents
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.