feynman

Teaches topics through iterative explain-and-re-explain loops using the Feynman technique.

1|Updated May 4, 2026
One-click install
npx skills add https://github.com/wesbragagt/nixos-config --skill feynman-wesbragagt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feynman
Source: https://github.com/wesbragagt/nixos-config/tree/main/home/skills/feynman
Command: npx skills add https://github.com/wesbragagt/nixos-config --skill feynman-wesbragagt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Passive reading and one-shot explanations rarely reveal whether you truly understand a topic. This Skill turns learning into an interactive loop that exposes gaps in your understanding and re-teaches only what you missed until you can explain the topic on your own. ## Core Features & Use Cases - Calibrated Explanations: Starts with a short question about your familiarity, then delivers a plain-language explanation of one core idea with a concrete analogy. - Structured Grading: Silently checks your re-explanation for accuracy, completeness, mechanism, jargon leaks, and analogy fit. - Targeted Re-teaching: Names exactly what landed and what is missing, then re-teaches only the gap with a fresh angle, looping until your explanation passes all checks. - Use Case: Ask it to teach you how HTTPS handshakes work; after each attempt to explain it back, you get specific feedback on what you got right and what to fix. ## Quick Start Ask the assistant to teach you a topic using the Feynman technique, for example: teach me how DNS resolution works with the feynman skill.

Frequently Asked Questions about feynman

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I learn a topic with the Feynman technique?

The Feynman technique works by explaining a concept in simple language, then identifying what you cannot explain clearly. This Skill automates that loop: it explains one core idea, asks you to explain it back, grades your attempt, and re-teaches only the gaps until you pass.

How does the skill grade my explanation?

It silently checks five criteria: accuracy, completeness, whether you explain the mechanism rather than just the facts, jargon used without unpacking, and whether your analogy actually holds. It then names what landed and up to three concrete gaps.

Can I use the Feynman technique for very broad topics?

Broad topics like calculus are narrowed first by asking which subtopic to start with, such as derivatives, integrals, or limits. Each loop covers one core idea in roughly 150-250 words rather than the whole subject at once.

What happens if I keep failing to explain the same gap?

After two retries on the same gap, the Skill switches to an entirely different analogy instead of repeating the same explanation. It never dumps the full answer and never accepts a vague claim of understanding without a re-explanation.

When is the Feynman technique not the right approach?

It is designed for conceptual understanding, not for quick factual lookups or reference-style answers. If you only need a definition or a code snippet, a direct answer is faster than an interactive teaching loop.