feynman-explainer

Explains complex technical topics through a single causal reasoning chain for non-expert readers.

76|3|Updated Aug 7, 2026
One-click install
npx skills add https://github.com/Job-Yang/jobbyang-ai-skills --skill feynman-explainer-job-yang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feynman-explainer
Source: https://github.com/Job-Yang/jobbyang-ai-skills/tree/main/skills/feynman-explainer
Command: npx skills add https://github.com/Job-Yang/jobbyang-ai-skills --skill feynman-explainer-job-yang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI-generated summaries and research notes often pile up terms and bullet points, leaving readers with isolated facts they cannot connect or retell. This Skill forces explanations to follow one logical chain so a non-expert can genuinely understand the topic. ## Core Features & Use Cases - Logic-chain structure: Organizes explanations as problem → why naive approaches fail → real mechanism → new difficulty → resolution, instead of flat bullet lists. - Scaffolding removal: Analogies, difficulty callouts, and self-checks stay internal; the delivered text reads as a fluent article with no visible labels like "Feynman analogy" or "Point 1". - Style constraints: Plain language, term translation on first use, fresh everyday analogies per section, honesty about unknowns, and tables or diagrams where they clarify. - Use Case: Ask it to explain how a source code mechanism, paper, or product logic works, and receive a connected walkthrough a newcomer could retell in their own words. ## Quick Start Ask the assistant to use the feynman-explainer skill to explain how a specific technical mechanism works so a beginner can truly understand it.

Frequently Asked Questions about feynman-explainer

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

FAQPage Schema
How do I explain a complex technical concept to a non-expert?

Structure the explanation as one causal chain: state the problem, show why the naive approach fails, introduce the real mechanism, address the new difficulty it creates, then close the loop. Embed analogies in sentences and translate every term on first use.

What is the Feynman technique for explaining technical topics?

The Feynman technique tests understanding by requiring you to explain a topic so a layperson can follow it. This Skill operationalizes it as a five-step internal workflow whose scaffolding is removed from the final fluent article.

When should I use feynman-explainer instead of a quick summary?

Use it when the goal is genuine understanding of a mechanism, paper, or codebase, not a one-line answer. Skip it for quick factual replies, pure translation or polishing tasks, or when the user explicitly asks to keep it brief.

Can feynman-explainer write articles for external publication?

No. It is input-oriented, producing explanations for personal understanding of research or summaries. For outward-facing articles or public posts, the documentation directs you to the tangshan-style skill instead.

Why do AI-generated explanations feel shallow and how is this fixed?

They typically list parallel bullet points with no causal connection, so readers cannot relate the parts. This Skill forbids flat lists and requires each section to answer the previous section's question, forming one continuous reasoning chain.