Anthropic's /eli5 skill: two lines of instruction, one HTML file, no room for precision
A Claude Code skill that Anthropic staff reportedly use internally emits a single standalone HTML explainer built from big pictures and few words. The constraint is the product, and also the ceiling.
The Engineer · Build desk
What happened
- Thariq Shihipar of the Claude Code team introduced the eli5 skill on X on August 21, 2026, describing it as one people at Anthropic had been using a lot.
- The skill's output is locked to three constraints: one standalone HTML artifact, few words, and structure shown as pictures rather than prose.
- It is free under MIT through the anthropics/claude-plugins-community marketplace and installs with two commands.
- Asked to explain RAG, it returned four emoji-labelled steps compressed onto a single screen.
Why it matters
- What's now possible capability Explaining an internal system to a non-engineer no longer needs a doc site or a diagramming tool; the deliverable is one file that opens in a browser.
- What it limits constraint Anything decided by a threshold, a version number, or a failure mode cannot survive this format, because the format discards detail by design.
- Who's exposed exposure Once these files go into client materials, a knowingly lossy artifact reaches readers with no way to tell what was left out.
- Who has to decide decision Teams have to pick between letting the skill fire on its own trigger and always calling it with explicit diagram and flow requirements to get repeatable output.
The whole skill is two lines. The body that actually drives the model tells it to explain like someone who knows nothing about the topic, using an HTML artifact with big pictures and few words, then hands it `$ARGUMENTS` [7]. The `description` field, the part that decides when the skill fires, still says "explain a topic like I'm a 5 year old" [8]. dev.to reads that gap as deliberate: aiming at a literal five-year-old's vocabulary degrades accuracy, so the operative instruction was retuned toward stripping assumed background instead [20]. Practical effect for anyone reviewing installed plugins before letting them near customer-facing work: the field you read in the metadata is not the field that runs.
The gap between the two also shows up in output quality. Left alone, the skill sometimes produces fewer diagrams than you want [1]. The prompt dev.to used to get a usable RAG explainer specified at least three SVG diagrams and spelled out the flow to draw as a flowchart with arrows [2]. That prompt is longer and more prescriptive than the skill's own instruction, which means the constraint doing the work is supplied by the caller, not the skill [16].
Look at what came back. The four steps are gather documents, chop them into pieces, find similar chunks, read and answer, each with an emoji and a short phrase, sized to fit one screen [3]. None of those four steps names an embedding model or any ranking step [17]. dev.to is candid about this: the output is an entry point to what the mechanism even is, not a technically precise spec [13], and the skill optimises for getting the idea across over being correct [14]. For a new team member in week one that trade is right [15]. For anything where the omitted term is the operative one, the format has already thrown away the answer before you read it.
One more thing worth pinning. The plugin installs as version 1.0.0 at user scope [11], and dev.to notes its description of behaviour is current only as of August 2026 because Claude Code changes often [4]. So the same `/eli5` command run months apart is not guaranteed to yield the same explainer of the same system [18]. The artifact is durable, being a standalone HTML file [6]; the generator behind it is not pinned to anything you control. If these files end up in an onboarding folder, they are snapshots of a moving prompt, and nothing in the file says so.
The licensing is the cleanest part of the story: MIT, free, with Claude Code usage still billed under whatever plan you already have [9]. The cost is not the plugin. It is the review time nobody budgets for a document that was designed to be incomplete.
What to watch
- Whether a later release fixes the description field so the trigger text and the operative instruction describe the same audience.
- Whether the skill moves out of the community marketplace into a default Claude Code install, which would put it in front of users who never chose it.
- Whether the output holds up when pointed at a repository's own code, as in the /eli5 how does auth work in this project example, rather than at a textbook concept.
Clarity's read
What the record supports and how the coverage leans. The claims behind it follow.
Reality
- Evidence56
- Adoption24
- Hype gap+24
- Incentives44
- Confidence48
Claim ledger
Ranked by verification strength, evidence, and original report placement.
- [1]
Left to its own devices the skill sometimes generates fewer diagrams than wanted; adding an explicit condition such as "include at least 3 SVG diagrams" makes output more consistent.
- [2]
The prompt dev.to used asked /eli5 to explain RAG simply, not to use text only, to include at least 3 SVG diagrams, and to show the flow of gather documents, split them, search, generate an answer as a flowchart with arrows.
- [3]
The recreated RAG output reduced the process to four emoji-labelled steps sized to one screen: gather documents, split into chunks, find similar chunks, read and answer.
- [4]
dev.to states the article reflects Claude Code's spec as of August 2026 and warns that Claude Code updates frequently, so readers should check official docs for current behaviour.
- [5]
Thariq Shihipar of the Claude Code team published the eli5 skill and introduced it on X on August 21, 2026, calling it "a skill people at Anthropic have been using a lot lately."
- [6]
The output is locked to three constraints: a single standalone HTML artifact rather than a chat reply, "few words" information density, and "big pictures" as the mode of expression, with structure shown visually instead of described in prose.
- [7]
The SKILL.md body reads: "Explain like I'm someone who knows nothing about this topic, using a HTML artifact with big pictures and few words. Topic: $ARGUMENTS"
- [8]
The skill's description field, which controls when the skill triggers, still reads "Explain a topic like I'm a 5 year old", while the body text that shapes the output says "someone who knows nothing about this topic".
- [9]
The plugin is distributed free under the MIT license through the community marketplace anthropics/claude-plugins-community, and installs in two commands; Claude Code usage still follows the user's existing plan pricing.
- [10]
Installation is: claude plugin marketplace add anthropics/claude-plugins-community, then claude plugin install eli5@claude-community.
- [11]
claude plugin list reports eli5@claude-community at Version 1.0.0, Scope user, Status enabled.
- [12]
Typing /eli5 <topic> in Claude Code generates a jargon-free, diagram-heavy HTML explainer aimed at someone with zero background on the topic.
- [13]
dev.to describes the output as an entry point for grasping what the mechanism even is, not a technically precise spec.
- [14]
ELI5 is designed to optimise for "gets the idea across" over "is precisely correct."
- [15]
dev.to lists two work uses: explaining how an AI system works to non-engineers as a single shareable slide for internal proposals or client materials, and onboarding new team members.
- [16]
The prompt that produced a usable explainer is longer and more prescriptive than the skill's own operative instruction, so the diagram count and flow structure come from the caller rather than from the skill.
- [17]
The four-step RAG output names no embedding model and no ranking step.
- [18]
Because the plugin ships as 1.0.0 and the documented behaviour holds only as of August 2026 against a frequently updated Claude Code, the same /eli5 command is not guaranteed to produce the same explainer months apart.
- [19]
The skill went viral in August 2026 after Anthropic's own dev team mentioned they use it internally.
- [20]
According to dev.to the mismatch is a deliberate choice: literally targeting a 5-year-old's vocabulary tends to tank explanation accuracy, so the body is tuned toward stripping out assumed background knowledge instead.
Get this ledger inside ChatGPT. Ask about any of our stories and the answer brings its figure, each claim’s verdict and the sources. Free, no account.
Sources
1 independent publisher whose own reporting we read for this story.
- dev.toClaude Code's ELI5 Skill Explained: How It Works, Setup, and When to Use It
1 article · August 24, 2026
Topics and entities
Follow any of these and your For You feed starts watching them — no settings page required.
Topics
- Prompt EngineeringFollow
- Generated explainer artifactsFollow
- AI Developer ToolingFollow
- Claude Code SkillsFollow
Entities
- anthropics/claude-plugins-communityFollow
- MIT LicenseFollow
- dev.toFollow
- eli5 skillFollow
- Claude CodeFollow
- AnthropicFollow
- Retrieval-Augmented Generation (RAG)Follow
- Thariq ShihiparFollow