CtrlK
BlogDocsLog inGet started
Tessl Logo

eli5

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

57

3.30x
Quality

40%

Does it follow best practices?

Impact

86%

3.30x

Average score across 3 eval scenarios

SecuritybySnyk

Risky

Do not use without reviewing

Optimize this skill with Tessl

npx tessl skill review --optimize ./.agents/skills/eli5/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

32%

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 communicates a reasonable sense of what the skill does—simplifying technical language—but lacks explicit trigger guidance ('Use when...') and misses natural user phrasings. The techniques mentioned (metaphors, before/after comparisons) describe the approach rather than concrete capabilities, and the description would benefit from clearer scoping and trigger terms.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks to simplify, explain in plain language, ELI5, or make technical content more accessible.'

Include natural trigger terms users would actually say, such as 'simplify', 'plain English', 'ELI5', 'what does this mean', 'non-technical explanation'.

Specify the types of technical content this applies to (e.g., code documentation, API references, scientific papers) to reduce overlap with general writing or editing skills.

DimensionReasoningScore

Specificity

The description names a domain (technical jargon simplification) and some actions (before/after comparisons, metaphors, practical context), but these are more like techniques than concrete, discrete actions. It's not as vague as 'helps with documents' but not as specific as listing multiple distinct operations.

2 / 3

Completeness

The description answers 'what does this do' (transforms jargon into clear explanations) but completely lacks a 'Use when...' clause or any explicit trigger guidance. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and since the 'when' is entirely absent, this scores at 1.

1 / 3

Trigger Term Quality

Terms like 'technical jargon', 'clear explanations', and 'metaphors' are somewhat relevant but miss common user phrasings like 'explain this simply', 'ELI5', 'plain language', 'simplify', or 'what does this mean'. Users rarely say 'before/after comparisons' when requesting this kind of help.

2 / 3

Distinctiveness Conflict Risk

The focus on transforming technical jargon is somewhat distinctive, but 'clear explanations' is broad enough to overlap with general writing, editing, or documentation skills. The mention of specific techniques (metaphors, before/after) helps somewhat but doesn't fully carve out a unique niche.

2 / 3

Total

7

/

12

Passed

Implementation

47%

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

This skill has an exceptionally well-designed workflow with strong validation mechanisms (adversarial subagent review, quality checklist, decision framework), but it is severely undermined by its verbosity. At 500+ lines, it explains many concepts Claude already understands (what jargon is, how metaphors work, what rhetorical questions are) and could be condensed by 50-70% without losing actionable content. The anti-patterns section, while valuable, reads more like a post-mortem of past failures than efficient instruction.

Suggestions

Reduce the content by at least 50% — move the anti-patterns list, adversarial review prompt template, and output format template into separate referenced files, keeping only a brief summary and pointer in SKILL.md.

Cut the Philosophy section to 3-5 bullet points of constraints rather than explaining the reasoning behind each principle — Claude understands documentation best practices.

Remove explanations of what concepts are (e.g., 'Jargon — Unexplained terms, undefined acronyms, terms with dual meanings' — Claude knows what jargon is) and focus only on Cloudflare-specific or non-obvious constraints.

Add a concrete before/after example directly in the skill body showing a real input paragraph and the expected simplified output, rather than only describing the process abstractly.

DimensionReasoningScore

Conciseness

This skill is extremely verbose (~500+ lines) and explains many concepts Claude already knows — what jargon is, how to identify assumptions, what rhetorical questions are, how to structure documentation. The philosophy section, anti-patterns list, decision framework, and edge cases all contain significant padding. Much of this could be condensed to a fraction of its length while preserving all actionable guidance.

1 / 3

Actionability

The skill provides a concrete workflow (steps 1-9), a specific output template, and a detailed adversarial review prompt — all actionable. However, there are no executable code examples (the `/eli5` command is not a real tool invocation), and much of the guidance is philosophical rather than directly executable. The decision framework and anti-patterns are useful but presented as abstract rules rather than concrete demonstrations.

2 / 3

Workflow Clarity

The 9-step workflow is clearly sequenced with explicit validation checkpoints — particularly the adversarial review in Step 9 which serves as a robust feedback loop. The workflow includes confirmation gates (Step 4 asks which sections to simplify), content type detection with strategy mapping, and a quality checklist before finalizing. The adversarial subagent step is a strong validation mechanism for a content transformation task.

3 / 3

Progressive Disclosure

The skill references external files (references/content-type-guide.md, references/pattern-library.md, EXAMPLES_REFERENCE.md) which suggests appropriate content splitting, but no bundle files are provided so these references are unverifiable. The SKILL.md itself is monolithic — the anti-patterns section, decision framework, adversarial review prompt, and output template could all be separate referenced files rather than inline, given the document's extreme length.

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

metadata_version

'metadata.version' is missing

Warning

Total

10

/

11

Passed

Repository
cloudflare/cloudflare-docs
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.