CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

grammy-bots

Guides writing grammY Telegram bot handlers, middleware, and plugins. Use when creating or modifying bot commands, inline queries, callback queries, message handlers, or middleware.

Quality

86%

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

78%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-crafted, code-first skill that teaches a clear architectural pattern with executable examples and correct/wrong contrasts, staying within token budget and properly delegating API reference to official docs. The main improvements are removing the redundant checklist, filling in placeholder handler bodies, and adding an explicit verification step.

Suggestions

Trim duplication: the final 'Checklist' mostly restates 'Filter chain rules' and 'Separation of Concerns' — either cut it or drop the overlapping bullet items to save tokens (conciseness).

Replace placeholder handler bodies ('// Process the photo...', '/* handle link */') with one fully worked example, e.g. echoing ctx.message.reply_to_message.photo, so the pattern is copy-paste ready (actionability).

Add a verification checkpoint after handler creation, e.g. 'run the typecheck/build before considering the handler done', to close the validation gap (workflow_clarity).

DimensionReasoningScore

Conciseness

The body is lean, code-heavy, and assumes grammY knowledge (e.g., delegates filter-query details to a one-line official-doc link), but the final "Checklist" substantially repeats the "Filter chain rules" and "Separation of Concerns" sections — minor trimmable duplication matching anchor 4. Not 5 because not every token earns its place; far above anchor 3 since it never explains concepts Claude already knows.

4 / 5

Actionability

Gives concrete executable TypeScript (Composer setup, chatType scoping, boundary registration) plus CORRECT/WRONG contrasts of the core pattern, but the processing-handler bodies are placeholders ("// Process the photo...", "/* handle link */") and `shouldReplyToMessage` is undefined — minor gaps fitting anchor 4 rather than the fully copy-paste-ready coverage of anchor 5; well above anchor 3's pseudocode.

4 / 5

Workflow Clarity

Clear section sequence (file structure → core pattern → query language → context type → concerns → checklist) with a closing checklist of checkpoints, but there is no explicit validation step (e.g., typecheck or run the bot after writing a handler) — anchor 4 with a minor validation gap. Not capped at 3 since this is a code-pattern skill, not a destructive or batch operation.

4 / 5

Progressive Disclosure

A single self-contained SKILL.md with well-organized sections, where bulky detail (filter query language, Telegram Bot API) is delegated one level deep via clearly signaled official-doc links instead of being inlined — matching anchor 5's clear overview with well-signaled references and appropriate content split.

5 / 5

Total

17

/

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 that states concrete capabilities and pairs them with an explicit, specific 'Use when' clause covering the main trigger scenarios. The only weaknesses are a slightly generic lead verb and a few missing natural synonym terms.

DimensionReasoningScore

Specificity

Names the domain and several concrete artifacts ("handlers, middleware, and plugins", "bot commands, inline queries, callback queries, message handlers") with minor coverage gaps, matching anchor 4. Not 5 because the single generic verb "Guides writing" heads the action list rather than the multiple distinct concrete actions of a 5; clearly above anchor 3's 1-2 actions.

4 / 5

Completeness

Explicitly answers what ("Guides writing grammY Telegram bot handlers, middleware, and plugins") and when ("Use when creating or modifying bot commands, inline queries, callback queries, message handlers, or middleware") with concrete trigger phrases — exactly anchor 5. Above anchor 4 because the when-clause enumerates specific concrete triggers rather than a generic condition.

5 / 5

Trigger Term Quality

Phrases like "bot commands", "inline queries", "callback queries", and "message handlers" are natural terms a user working on this codebase would say, but common variations ("Telegram", "group/supergroup", "reply") are absent — good coverage with a few natural terms missing, anchor 4. Not 5 due to missing synonyms/extensions.

4 / 5

Distinctiveness Conflict Risk

"grammY Telegram bot handlers" defines a clear niche with distinct triggers (framework + platform specific), so it is unlikely to trigger for the wrong skill — anchor 5. Not 4, since no meaningful overlap risk with closely related skills exists.

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

divaltor/starlight

Path

.agents/skills/grammy-bots/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.