CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

eli5

Transform technical jargon into clear explanations using before/after comparisons, metaphors, and practical context

3.30x
Quality

75%

Does it follow best practices?

Impact

86%

3.30x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/eli5/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 body delivers an exceptionally actionable, well-validated 9-step workflow with a verbatim subagent prompt and exact output template, held back mainly by token-efficiency issues: the same guidance (mechanism accuracy, consequence chains, synonym glosses, glossary criteria) is repeated 2-5 times across Philosophy, Decision Framework, Anti-patterns, and the Checklist. One reference path is also cited without its references/ prefix.

Suggestions

Consolidate the duplicated guidance into single canonical sections — mechanism-accuracy warning, consequence-chain rule, synonym-gloss rule, and GlossaryTooltip criteria each appear 2-5 times across Philosophy, Step 6, Decision Framework, Anti-patterns, and the Quality Checklist; stating each once and referencing it would cut significant tokens.

Fix the "Full examples: EXAMPLES_REFERENCE.md" reference to "references/EXAMPLES_REFERENCE.md" so the path matches the actual bundle layout.

Consider moving the ~75-line adversarial-review prompt template into a references file (loaded only when Step 9 runs), keeping a short pointer plus the non-negotiable framing in SKILL.md.

DimensionReasoningScore

Conciseness

The body is mostly efficient, domain-specific guidance, but guidance is systematically duplicated: mechanism-accuracy warnings appear in Philosophy ("a plausible-sounding explanation that describes the wrong mechanism is worse than jargon"), the adversarial prompt focus area 1, anti-pattern 6, and the checklist; consequence-chain guidance appears twice (Decision Framework and anti-pattern 2); synonym-gloss guidance twice (Decision Framework and anti-pattern 3); GlossaryTooltip criteria twice (Step 6 and Decision Framework). This matches "mostly efficient but includes some unnecessary explanation or could be tightened" — not 2, since none of it explains concepts Claude already knows and each instance is terse.

3 / 5

Actionability

Guidance is fully executable: a copy-paste-ready adversarial-review subagent prompt with fill-in placeholders, an exact output template, concrete quantitative limits ("2-4 sentences inline", "1-2 per major concept, 5-15 lines each", "3-5 verification commands max"), specific commands, and a worked example table. Not 4: there are no significant gaps — the common cases are covered with specific instructions.

5 / 5

Workflow Clarity

The 9-step workflow is clearly sequenced with explicit validation checkpoints (user confirmation of content type in Step 2, the GlossaryTooltip quality gate in Step 6, the mandatory adversarial review in Step 9) and feedback loops (flag uncertainty for the writer, fix-flagged-issues recovery option). A final quality checklist covers the complex process. Not 4: validation is explicit and built in at every risky step, not implicit.

5 / 5

Progressive Disclosure

The body has good structure with a References section pointing one level deep to real bundle files (references/content-type-guide.md and references/pattern-library.md, both verified to exist), matching "references mostly clear; minor organization gaps". The gap: the body cites "EXAMPLES_REFERENCE.md" while the actual file lives at references/EXAMPLES_REFERENCE.md, and the ~75-line adversarial-review prompt is inlined in the body (though arguably deliberate, since it must be passed verbatim). Not 3 because references are clearly signaled in a dedicated section and the split is otherwise appropriate; not 5 because of the incorrect path and the heavy inlining.

4 / 5

Total

17

/

20

Passed

Description

58%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 concrete and specific about capabilities with a distinct niche, but it omits any "when to use" guidance and misses the natural trigger phrases (ELI5, simplify, plain English) users would most likely say. Adding an explicit trigger clause would raise completeness and trigger-term quality together.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to simplify, explain like I'm five (ELI5), or make technical documentation accessible to non-experts" — this addresses the missing 'when' that caps completeness at 3.

Include the natural synonyms users say ("plain English", "simplify", "explain like I'm five") in the description to improve trigger-term coverage beyond just "technical jargon".

Mention the terminology/glossary analysis capability (a core part of the skill's workflow) to close the coverage gap in specificity.

DimensionReasoningScore

Specificity

Names the domain ("technical jargon") and several concrete actions ("before/after comparisons", "metaphors", "practical context"), matching the anchor for several specific actions with minor gaps. It is below 5 because capabilities like terminology analysis and glossary work are absent, and above 3 because more than 1-2 actions are listed.

4 / 5

Completeness

The description gives a clear "what" ("Transform technical jargon into clear explanations using before/after comparisons, metaphors, and practical context") but contains no "when to use" clause or equivalent trigger guidance, which the judging guidelines cap at 3. It is not 2 because the "what" is concrete, not vague.

3 / 5

Trigger Term Quality

"technical jargon", "clear explanations", and "metaphors" are relevant keywords, but common natural phrases users would say ("explain like I'm five", "simplify", "plain English", "ELI5") are missing. This matches the anchor for some relevant keywords but missing common variations or synonyms.

3 / 5

Distinctiveness Conflict Risk

"Transform technical jargon into clear explanations" carves a fairly distinct niche (audience-level simplification of technical docs) that mostly conflicts only with closely related writing/editing skills. Not 5 because the description lacks explicit trigger phrases that would fully disambiguate it from general editing skills.

4 / 5

Total

14

/

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.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

cloudflare/cloudflare-docs

Path

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