Guides

Make Any Complex Topic Click With the Claude ELI5 Skill

In this guide, you will learn to make Claude a better teacher with the ELI5 skill.

beginner 4 steps

Introduction

In this guide, you will learn to make Claude a better teacher with the ELI5 skill. Then you will learn to test it to see the improvement yourself.

Step-by-step 4 steps

Instructions

  1. Step 1 of 4

    Install the ELI5 Skill

    ELI5 is a public Claude skill. It gives Claude instructions for explaining a hard topic in simpler language for a particular audience.

    GitHub README for the ELI5 repo showing the Installation section with a git clone command and a link to the eval-system guide
    GitHub README for the ELI5 repo showing the Installation section with a git clone command and a link to the eval-system guide

    Open a terminal in a folder you don't mind using for this, then clone the repo and copy the skill folder into Claude Code's skills directory:

    Prompt
    git clone https://github.com/DreambigOu/ELI5.git
    cp -r ELI5/skills/eli5 ~/.claude/skills/eli5

    Restart Claude Code, then run /skills to confirm ELI5 appears in the list.

    For claude.ai, skip the terminal. Open the eli5 skill folder in the GitHub repo, download SKILL.md, and drag it into a chat. First turn on Code execution and file creation in Settings > Capabilities. An Enterprise admin can also turn on skill and plugin scanning in Organization settings. If that setting is off, read the file yourself before you trust it.

    Pro tip: Skim SKILL.md before trusting any skill with real prompts. It's a plain-text file, so reading it takes a minute and tells you exactly what the skill will and won't do.
  2. Step 2 of 4

    Run the Skill on a Real Prompt

    Try it once before doing anything else:

    Prompt
    Explain like I'm five what skills are and how you can create one.
    Claude Code terminal output where the ELI5 skill explains what a Claude skill is using a recipe card cookie analogy
    Claude Code terminal output where the ELI5 skill explains what a Claude skill is using a recipe card cookie analogy

    You can also point the skill at a document, codebase, or error message. The useful part is getting an explanation that fits the person reading it.

  3. Step 3 of 4

    Ask Claude to Build Its Own Test Cases

    Trying a skill once tells you what it sounds like. A quick evaluation tells you whether it changes anything.

    The ELI5 repo includes an evaluation setup. Ask Claude to use its format in eli5-workspace/evals.json:

    Prompt
    Set up two test cases for me from this repo. You'll find the format in the GitHub instructions. Make one about the NBA playoffs and make one about golf.

    Claude adds the prompts and pass/fail checks to evals.json. You do not have to build the evaluation system yourself.

    Diff view of evals.json with two new test cases added: an NBA-playoffs prompt for a 10-year-old and a golf-scoring prompt for a parent, each with scoring assertions
    Diff view of evals.json with two new test cases added: an NBA-playoffs prompt for a 10-year-old and a golf-scoring prompt for a parent, each with scoring assertions
  4. Step 4 of 4

    Run the Eval and Read the Score, Not the Vibe

    Ask Claude for the command for each new test, then run it from the cloned repo folder. The command uses the test id in evals.json. In our example, NBA was test 4 and golf was test 5:

    Prompt
    python3 eli5-workspace/run-evals.py --test=4
    python3 eli5-workspace/run-evals.py --test=5

    Keep --test=N. Without it, the script reruns every case in evals.json.

    Terminal running run-evals.py, showing the with-skill and baseline configs kicking off for the NBA-playoffs test case
    Terminal running run-evals.py, showing the with-skill and baseline configs kicking off for the NBA-playoffs test case

    Each test answers the prompt with ELI5 and without it, then grades both against the checks and prints a pass-rate summary.

    We tested NBA playoffs and golf, and both passed with ELI5 and without it. Those topics were easy enough that baseline Claude explained them well too. If that happens to you, pick a harder topic before deciding the skill is not helping.

    Pro tip: If both versions pass, try something harder or more specific, such as a piece of your own code or a dense internal process. The ELI5 repo's published evals cover tougher tests, including explaining a database index to a 5-year-old, a codebase to a manager, and a git merge conflict to a 5th grader. That is the repo's earlier benchmark, not a result we reproduced in this guide.

You're done

That's the whole workflow

Mark it complete to save your progress. Background and answers to common questions follow below.

Keep going

Keep learning with Rundown Pro

A guide shows you one workflow. Pro opens the full course library, so you can learn the whole system behind it.

  • Every on-demand course
  • Certifications on completion
  • Group office hours and member perks

$29/mo, cancel anytime

Overview Back to the steps

Background and context

Who This Is Useful For

  • Sarah in ops who needs to explain a new process to a new hire and a director without rebuilding the prompt each time.
  • Marcus in consulting who wants to check a skill before using it on a client deliverable.
  • Anyone installing skills in Claude Code or claude.ai who wants to see whether a skill changes the output.

What You Will Build

You will install ELI5, use it to explain a hard topic for one audience, then test the same prompt with the skill on and off.

Terminal output showing a PASS RATE SUMMARY comparing an ELI5 skill run against a no-skill baseline, both at 100% with a 0.0% delta
Terminal output showing a PASS RATE SUMMARY comparing an ELI5 skill run against a no-skill baseline, both at 100% with a 0.0% delta

What You Need To Get Started

  • Claude Code with terminal access
  • A claude.ai account with Code execution and file creation turned on in Settings > Capabilities if you also want to use the skill outside the terminal (any plan works, including Free)
  • Git and Python installed
  • The DreambigOu/ELI5 GitHub repository

Going Further

Give Claude any skill's GitHub repo and ask it to build an evaluation that checks whether the skill changes the result. Use the same pattern for every skill you install.