Metaphor & Analogy Explainer skill for Claude and Codex
Explains a hard idea through one analogy the audience already knows, in the length you pick, with an optional key to the real technical terms.
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when a technical or abstract topic needs explaining to a non-expert through one familiar analogy. Do not use for a full science explainer with techniques and a why-it-matters ending, or a teaching lesson plan. Related topics: education, writing, utility.
What it will ask you for
- Complex topic (free text, e.g. "Quantum Computing or API Rate Limiting")
- Audience (choose one: 5-year-old child, High School Student, Non-technical Executive, Grandparent)
- Analogy theme (choose one: Cooking/Food, Sports, Cars/Mechanics, Magic/Fantasy, Everyday Life)
- Length (choose one: 1 short paragraph, A brief story, Bullet points)
- Include a key to the real technical terms (choose one: Yes, No)
How it works
- Choose one analogy from the chosen theme that fits how the topic really works.
- Map each key part of the topic to a part of the analogy and check the mapping is one to one.
- Write the explanation at the chosen length using only words the audience already has.
- State where the analogy stops being accurate in a sentence.
- Add the technical term key when it is switched on, pairing each analogy element with its real term.
What you get
The explanation in the chosen length, one sentence naming where the analogy breaks down, and a term key when requested.
What it watches out for
- Mixing two analogies in one explanation, which makes the mapping unclear.
- Letting the analogy imply something false about the topic without ever saying so.
- Using jargon in the explanation itself, defeating the audience fit.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.