Concept Decoder
by @onlybelter
Deconstructs complex concepts with a layered, intuition-first pipeline (prereqs → motivation → analogies → math → connections → tests). Use when user asks 'w...
clawhub install concept-decoder📖 About This Skill
name: "concept-decoder" description: "Deconstructs complex concepts with a layered, intuition-first pipeline (prereqs → motivation → analogies → math → connections → tests). Use when user asks 'what is X', wants intuition behind formulas, or feels stuck."
Concept Decoder
Overview
This skill systematically deconstructs complex, abstract, or formula-heavy scientific concepts — from quantum mechanics to abstract algebra to statistical physics — using a first-principles cognitive pipeline. It transforms opaque jargon into layered, intuitive understanding by reversing the textbook order: motivation before formalism, analogy before algebra, connection before isolation.
Language policy: Respond in the same language the user writes in. If the user writes in Chinese, deliver the full decode in Chinese. If in English, in English. For mixed input, default to English.
When to Use This Skill
Use /decode or trigger this skill when:
Do NOT use this skill when:
Depth Levels
The user can specify a depth level in the trigger command. Default is Standard.
| Level | Trigger Syntax | Layers Covered | Approx. Length |
|-------|---------------|----------------|----------------|
| Quick | /decode X, quick | Layers 1–2 only | ~500 words |
| Standard | /decode X *(default)* | Layers 0–5 | ~1500–2500 words |
| Deep | /decode X, deep | All 6 layers | ~3000–5000 words |
Examples:
/decode Laplacian operator
/decode replica symmetry breaking, deep
/decode group theory, quick
/decode 拉普拉斯算子
/decode 复本对称破缺，深度模式
Core Philosophy
> "You don't understand something until you can explain what problem it solves for someone who has never heard of it."
Three anti-patterns this skill avoids: 1. ❌ Starting with the formal definition (this is how textbooks lose people) 2. ❌ Skipping the "why" and jumping to "how" (formulas without motivation are dead symbols) 3. ❌ Treating the concept in isolation (understanding = connecting to what you already know)
Workflow: The Six-Layer Deconstruction
Layer 0: Prerequisite Scan
[STOP POINT — present the tree, then WAIT for user response before proceeding]Before deconstruction begins:
Example for RSB:
RSB
├── Replica trick
│ ├── Partition function Z
│ │ └── Statistical mechanics basics
│ └── Quenched vs. annealed disorder
├── SK model
│ ├── Ising model
│ └── Mean-field theory
├── Order parameter (overlap q)
│ └── Spontaneous symmetry breaking
└── Free energy landscape
└── Metastability
If prerequisite gaps are too large (5+ unknown concepts):
Layer 1: The Problem — Why Does This Concept Exist?
Every concept was invented to solve a problem. Start there.
Template: > Before [CONCEPT] existed, people tried to understand [PHENOMENON]. > The existing tools ([PREVIOUS APPROACHES]) failed because [SPECIFIC FAILURE]. > [CONCEPT] was introduced by [WHO, WHEN] to resolve this failure.
Requirements:
Example for RSB: > Sherrington and Kirkpatrick (1975) proposed a mean-field model for spin glasses. > Applying the replica trick with the simplest assumption — that all replicas are equivalent > (replica symmetric, RS) — gives a free energy that yields negative entropy at low temperature. > This is physically absurd. Something in the RS assumption must be wrong. > Parisi (1979) realized: the replicas are NOT equivalent — their symmetry is broken.
Layer 2: The Intuitive Picture — Analogy Before Algebra
Provide at least two analogies at different levels:
1. Everyday analogy (for the "aha" moment): - Must be concrete, visual, experiential - Acceptable to be imperfect — explicitly state where the analogy breaks down
2. Cross-domain scientific analogy (for structural understanding): - Map the concept to a parallel structure in a domain the user already knows - Highlight what is structurally identical and what differs
Requirements:
Example for RSB: > Everyday analogy: Imagine a mountain landscape with many valleys. A ball rolling > on this landscape gets trapped in whichever valley it falls into — not necessarily the > deepest one. RS assumes there's essentially one valley. RSB says: no, there's a > hierarchy of valleys within valleys within valleys, like a fractal. > > Where it breaks: Real spin glass landscapes have ultrametric structure > (the "distance" between valleys obeys a tree metric), which has no everyday counterpart.
Layer 3: The Mathematical Skeleton — Formulas as Sentences
Now introduce the math, but treat every formula as a sentence that says something.
Protocol — for each key equation, provide THREE things: 1. The formula itself (properly typeset in LaTeX) 2. What it says in words (one sentence, no jargon) 3. What each symbol "wants to be" (physical/geometric meaning)
Build formulas incrementally: start from the simplest version, add complexity one term at a time. Mark the critical step with ⚡.
Structure:
Step 1: [Simplest relevant equation]
Words: ...
Symbols: ...Step 2: [Add one layer of complexity]
Words: ...
What changed and why: ...
⚡ Step 3: [The key equation where the concept lives]
Words: ...
THIS is where [CONCEPT] enters — because ...
Step 4: [Consequence / result]
Words: ...
This tells us: ...
Requirements:
Citation format for references: Author(s), *Title*, Journal/Book, Year. (e.g., Parisi, G., *Order parameter for spin glasses*, PRL, 1983.)
Layer 4: The Concept Map — Connections and Boundaries
Place the concept in its relational network across four directions:
| Direction | Question to answer | |-----------|-------------------| | 4a. Upward (generalizations) | What broader framework contains this concept? What is it a special case of? | | 4b. Downward (special cases) | What are the simplest non-trivial examples? What does it reduce to in limits? | | 4c. Lateral (surprising links) | Where does the same mathematical structure appear in completely different fields? | | 4d. Boundary (where it breaks) | Under what conditions does this concept fail? What replaces it beyond those boundaries? |
Output format: Prefer a structured text map; offer a Mermaid diagram for complex dependency networks.
Example for RSB:
Generalizes: Spontaneous symmetry breaking (but in replica space, not physical space)
Special case: 1-step RSB (simplest non-trivial case; applies to some structural glasses)
Lateral link: Ultrametricity in RSB ↔ Taxonomy trees in biology ↔ p-adic numbers in number theory
Boundary: RSB is a mean-field result; in finite dimensions, the droplet model may apply instead
Layer 5: The Litmus Tests — Do You Really Understand It?
Provide three diagnostic questions of increasing depth. Hide answers behind spoiler markers.
| Test | Type | Purpose | |------|------|---------| | Q1 | Explain-to-a-friend | Tests conceptual grasp of Layer 1–2 | | Q2 | Modify-one-thing | Tests structural understanding of Layer 3 | | Q3 | Cross-domain transfer | Tests depth of Layer 4 connections |
Failure routing:
Example for RSB:
> Q1: If replica symmetry were NOT broken, what physically absurd thing would happen?
> Check answer
Negative entropy at low T in the SK model — thermodynamically impossible.
> Q2: What changes in the Parisi solution if you go from full RSB to 1-step RSB?
> Check answer
The continuous order parameter function q(x) becomes a step function with a single jump.
> Q3: Why does the same ultrametric structure appear in both spin glasses and combinatorial optimization?
> Check answer
Both involve rugged free energy / cost landscapes with hierarchical valley structure; the ultrametric distance measures how "different" two solutions are at each level of the hierarchy.
Layer 6 (Optional): Historical and Human Context
Trigger condition: Activate automatically in Deep mode, or when the user explicitly asks "who invented this?" / "what's the history?"
For concepts with rich intellectual history, cover:
This layer provides the "glue" that makes a concept memorable and situates it in the living tradition of science.
Formatting Standards
Math Rendering
$$...$$ for display math, $...$ for inlineVisual Aids
Length Calibration
Error Handling
Concept is too broad
Concept has no clear consensus
User's prerequisite gaps are too large
Concept is already well-known to the user
Examples
Example 1: Quick decode
User: /decode Laplacian operator, quick
→ Layer 1: "The Laplacian measures how much a function at a point differs from its
neighborhood average. It was needed because gradient alone couldn't capture
'local curvature in all directions simultaneously'."
→ Layer 2: Analogy — "If you're colder than your neighbors, heat flows in (∇²T > 0).
If warmer, heat flows out (∇²T < 0). ∇²T = 0 means thermal equilibrium locally."
Cross-domain: "In image processing, the Laplacian detects edges — pixels that
differ sharply from their neighbors."
Where it breaks: "Works cleanly for scalar fields; for vector fields, acts component-wise."
Example 2: Deep decode
User: /decode replica symmetry breaking, deep
→ Full 6-layer treatment:
Layer 0: Prerequisite tree (Ising model, mean-field theory, replica trick, ...)
Layer 1: SK model → RS assumption → negative entropy paradox
Layer 2: Fractal valley landscape analogy + optimization landscape cross-link
Layer 3: Parisi ansatz, q(x) order parameter function, ultrametricity ⚡
Layer 4: RSB ↔ p-adic numbers ↔ taxonomy trees ↔ constraint satisfaction
Layer 5: Three litmus tests with spoiler answers
Layer 6: Parisi (1979) → controversy → Guerra/Talagrand proof (2002–2006) → legacy
Notes
Input/Output
Input
Output
💡 Examples
Example 1: Quick decode
User: /decode Laplacian operator, quick
→ Layer 1: "The Laplacian measures how much a function at a point differs from its
neighborhood average. It was needed because gradient alone couldn't capture
'local curvature in all directions simultaneously'."
→ Layer 2: Analogy — "If you're colder than your neighbors, heat flows in (∇²T > 0).
If warmer, heat flows out (∇²T < 0). ∇²T = 0 means thermal equilibrium locally."
Cross-domain: "In image processing, the Laplacian detects edges — pixels that
differ sharply from their neighbors."
Where it breaks: "Works cleanly for scalar fields; for vector fields, acts component-wise."
Example 2: Deep decode
User: /decode replica symmetry breaking, deep
→ Full 6-layer treatment:
Layer 0: Prerequisite tree (Ising model, mean-field theory, replica trick, ...)
Layer 1: SK model → RS assumption → negative entropy paradox
Layer 2: Fractal valley landscape analogy + optimization landscape cross-link
Layer 3: Parisi ansatz, q(x) order parameter function, ultrametricity ⚡
Layer 4: RSB ↔ p-adic numbers ↔ taxonomy trees ↔ constraint satisfaction
Layer 5: Three litmus tests with spoiler answers
Layer 6: Parisi (1979) → controversy → Guerra/Talagrand proof (2002–2006) → legacy