---
name: metaphor-analogy-explainer
description: "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. 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."
---

# Metaphor & Analogy Explainer

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.

## When to use

Use this skill when a technical or abstract topic needs explaining to a non-expert through one familiar analogy. Do not use it for a full science explainer with techniques and a why-it-matters ending, or a teaching lesson plan.

## Workflow

1. Ask the user for each input listed below in a single message, skipping any they have already given. Where options are listed, offer them, but accept other answers too.
2. Choose one analogy from the chosen theme that fits how the topic really works.
3. Map each key part of the topic to a part of the analogy and check the mapping is one to one.
4. Write the explanation at the chosen length using only words the audience already has.
5. State where the analogy stops being accurate in a sentence.
6. Add the technical term key when it is switched on, pairing each analogy element with its real term.

## Inputs

- **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)

## Output

The explanation in the chosen length, one sentence naming where the analogy breaks down, and a term key when requested.

## Prompt template

Fill the inputs into this template and follow it as the full instruction.

### Metaphor and Analogy Explainer

Explain a complex idea through an analogy the audience will recognise.

- Complex topic: {{Complex topic}}
- Audience: {{Audience}}
- Analogy theme: {{Analogy theme}}
- Length: {{Length}}
- Include a key to the real technical terms: {{Include a key to the real technical terms}}

Pick a single analogy from the theme and stay inside it. Map the parts of the topic to parts of the analogy one for one, and state where the analogy breaks down so it does not mislead. Use words the audience already has. If the key is on, add a short list that pairs each analogy element with the technical term it stands for.

Return the explanation in the chosen length, followed by the term key if requested.

## Pitfalls

- 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.
