szeyu

concept-explainer

1
0
# Install this skill:
npx skills add szeyu/vibe-study-skills --skill "concept-explainer"

Install specific skill from multi-skill repository

# Description

ELI5-style explanations with analogies and multiple examples. Explains concepts at different levels (ELI5, high school, undergraduate, graduate). Uses real-world analogies and visual metaphors. Use when explaining difficult concepts, clarifying confusing topics, or learning new subjects. Triggers - explain concept, ELI5, explain like I'm 5, what is, how does, why does, analogy for, simple explanation.

# SKILL.md


name: concept-explainer
description: ELI5-style explanations with analogies and multiple examples. Explains concepts at different levels (ELI5, high school, undergraduate, graduate). Uses real-world analogies and visual metaphors. Use when explaining difficult concepts, clarifying confusing topics, or learning new subjects. Triggers - explain concept, ELI5, explain like I'm 5, what is, how does, why does, analogy for, simple explanation.


Concept 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

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.