CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

telegram-e2e-userbot

Prove user-visible OpenClaw Telegram behavior on Telegram's Test Server with Convex-leased team credentials; drive real-user turns and record messages, edits, deletions, reactions, typing, or rich content.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 SKILL.md body is an exceptionally well-written operational runbook: lean, fully executable, and sequenced with validation gates, recovery loops, and a completion checklist. Its one real weakness is the bundle structure — the referenced verification map and runtime reference files are missing from the bundle, breaking the disclosure chain the workflow depends on.

Suggestions

Ship the referenced files (features/README.md and features/runtime-reference.md, plus scripts/e2e/mock-openai-server.mjs) in the bundle, or inline minimal proof-selection and recovery guidance in SKILL.md so the workflow does not dead-end at step 2.

Add a short map of the scripts/ directory (which scripts are entry points vs. test helpers vs. preloads), since 46 flat files are currently unnavigable from SKILL.md.

Verify every relative link in SKILL.md resolves within the published bundle, especially features/runtime-reference.md#retained-run-recovery, which the cleanup failure path depends on.

DimensionReasoningScore

Conciseness

The body is dense, imperative, and free of padding — every sentence carries repo-specific constraints (e.g., "Readiness from a released lease never qualifies a later run") with zero explanation of concepts Claude already knows. It matches the "every token earns its place" anchor; no trimmable over-explanation was found to justify a 4.

5 / 5

Actionability

Provides copy-paste-ready commands for the common case — the full runner invocation with concrete flags ("--dm --text 'Please answer with OPENCLAW_E2E_OK only.' --record ... --output ..."), the doctor command, and explicit success criteria ("Require `ok: true`, `botApiTransport: \"direct-https\"`, and `botApiProxy: false`"). Variant guidance (--create-forum, --chat, --source-gateway) is specific about when each applies.

5 / 5

Workflow Clarity

A clearly sequenced four-step workflow (Prepare → Select the proof → Check readiness and run → Judge and clean up) with explicit validation gates, error-recovery feedback loops ("A send-confirmation timeout can follow an accepted send: preserve observed events and reconcile them, rather than blindly resending"), a repair-before-retry rule, and a completion checklist. This matches the top anchor including feedback loops and checklists.

5 / 5

Progressive Disclosure

The body's structure is exemplary — one-level-deep, well-signaled references such as "[the verification map](features/README.md)" and "[runtime reference](features/runtime-reference.md)" — but scored against the actual bundle, those two referenced files (and scripts/e2e/mock-openai-server.mjs) do not exist, and scripts/ is a flat 46-file dump with no navigation from SKILL.md. Step 2's primary instruction ("Read the verification map, then only the recipe for the behavior under test") is broken at its first hop, which is a larger organization gap than the "minor organization gaps" allowed at 4.

3 / 5

Total

18

/

20

Passed

Description

75%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 highly specific and distinctive, with strong natural keywords around Telegram recording events, but it completely lacks an explicit "Use when..." trigger clause, leaving the "when to use this skill" half of its job implicit. Adding explicit trigger guidance would move it to the top band.

Suggestions

Append an explicit trigger clause such as "Use when asked to prove or verify OpenClaw's Telegram behavior, or when the user mentions Telegram e2e, the Test Server, message edits/deletions, reactions, or typing indicators."

Trade some jargon ("Convex-leased team credentials") for natural user-facing phrasing like "team QA credentials" so the trigger terms match what users actually say.

Mention the visual-claims capability ("inspect actual Telegram client screenshots") in the description, since it is a key differentiator users would ask about.

DimensionReasoningScore

Specificity

Enumerates concrete actions — "drive real-user turns and record messages, edits, deletions, reactions, typing, or rich content" — giving comprehensive coverage of the observable Telegram events the skill captures. It is not a 4 because the recorded-event list leaves no minor gaps in coverage of the domain.

5 / 5

Completeness

The "what" is clear (prove user-visible behavior, drive real-user turns, record lifecycle events), but there is no "Use when..." clause or equivalent explicit trigger guidance — the "when" is only weakly implied by the leading verb "Prove". Per the rubric guideline, a missing explicit trigger clause caps completeness at 3; it is not 4 because the when is never stated explicitly.

3 / 5

Trigger Term Quality

Contains natural trigger terms a user would say — "Telegram", "Test Server", "record messages, edits, deletions, reactions, typing". It is not 5 because jargon like "Convex-leased team credentials" crowds out a few natural phrasings (e.g., "verify", "end-to-end", "screenshot") and no synonyms or variations are offered.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — "OpenClaw Telegram behavior on Telegram's Test Server with Convex-leased team credentials" — with distinct triggers and virtually no risk of matching an unrelated skill. It clearly matches the top anchor rather than the "minor overlap" anchor at 4.

5 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 3 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing, 1 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

openclaw/openclaw

Path

.agents/skills/telegram-e2e-userbot/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.