About concept-explainer
Concept Explainer is a skill for producing explanations of concepts at four levels, from beginner to graduate. It uses a consistent structure with analogies, mechanisms, examples, and common misconceptions for educational writing.
Key features
- 01Four audience difficulty levels
- 02Structured explanation outline
- 03Analogy patterns for concepts
- 04Guidance for examples and misconceptions
Use cases
- 01Explain a topic to beginners
- 02Adapt technical material for students
- 03Structure a concept guide at several levels
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ szeyu/ vibe-study-skills --skill concept-explainerAfter installing, type/concept-explainerin Claude Code to confirm it loaded.
Details
From the project READMEConcept Explainer
Clear explanations with analogies and examples at multiple difficulty levels.
Explanation Levels
| Level | Audience | Style |
|---|---|---|
| ELI5 | Complete beginner | Simple words, everyday analogies |
| High School | Some background | Basic terminology, clear examples |
| Undergraduate | Foundational knowledge | Technical terms, detailed mechanisms |
| Graduate | Advanced understanding | Nuances, edge cases, research context |
Explanation Framework
flowchart TB
A[Concept] --> B[One-Sentence Summary]
B --> C[Core Analogy]
C --> D[How It Works]
D --> E[Examples]
E --> F[Common Misconceptions]
Template: Standard Explanation
# [Concept Name]
## In One Sentence
[Concept] is [simple definition] that [what it does/why it matters].
## The Analogy
Think of [concept] like [familiar thing]. Just as [familiar thing does X], [concept] does [Y].
## How It Actually Works
[More detailed explanation with proper terminology]
### Key Components
1. **Component 1:** What it is and what it does
2. **Component 2:** What it is and what it does
3. **Component 3:** How they work together
## Examples
### Example 1: [Simple]
[Everyday example with the concept]
### Example 2: [Applied]
[Real-world application]
### Example 3: [Advanced]
[Complex scenario]
## Common Misconceptions
- ❌ **Myth:** [Wrong belief]
- ✅ **Reality:** [Correct understanding]
## Related Concepts
- [Concept A] - [How it relates]
- [Concept B] - [How it relates]
Analogy Patterns
Structure Analogy
"[Concept] is like a [familiar object] where [component A] is like [part 1] and [component B] is like [part 2]."
Example: "A cell is like a factory where the nucleus is the control room and mitochondria are the power plants."
Process Analogy
"[Concept] works like [familiar process]. First, [step 1 comparison], then [step 2 comparison]."
Example: "Osmosis works like crowds at a concert. People naturally spread from crowded areas to less crowded areas."
Scale Analogy
"If [large/small thing] were the size of [familiar object], then [other element] would be..."
Example: "If an atom were the size of a football stadium, the nucleus would be a marble at the center."
Level Adjustments
ELI5 Techniques
- No jargon
- 1-2 sentence explanations
- Everyday objects as analogies
- "Imagine if..." scenarios
- Avoid numbers unless simple
High School Level
- Introduce key terms with definitions
- Simple diagrams
- Concrete examples
- Cause and effect clear
Undergraduate Level
- Technical vocabulary expected
- Mathematical relationships
- Mechanism details
- Multiple interconnected concepts
Graduate Level
- Assumptions and limitations
- Historical development
- Current research questions
- Edge cases and exceptions
Example: Explaining "Entropy" at Multiple Levels
ELI5
"Entropy is messiness. Your room wants to get messy by itself, but you have to work to clean it up."
High School
"Entropy measures disorder in a system. In nature, things tend to become more disordered over time - ice melts, buildings crumble, things mix together."
Undergraduate
"Entropy (S) is a thermodynamic quantity measuring the number of microscopic configurations (microstates) available to a system. ΔS = Q/T for reversible processes. The Second Law states entropy of an isolated system never decreases."
Graduate
"Entropy connects to information theory through Boltzmann's equation S = k ln Ω. Maximum entropy methods provide principled uncertainty quantification. Non-equilibrium thermodynamics extends these concepts to systems with entropy production."
Quality Checklist
- Opens with simple one-liner
- Includes relatable analogy
- Provides 2-3 examples at different scales
- Addresses common misconceptions
- Builds from simple to complex
- Uses consistent terminology
- Connects to related concepts