educational-html-preplisted
Install: claude install-skill srfinch17/peckworks-skills-laboratory
# Educational HTML Prep
Turn a topic the maintainer needs to *learn and defend in interviews* into a page he can read top-to-bottom
and walk away genuinely understanding: Feynman-grade teaching inside the existing mission-control
visual identity. This is for his job-search learning workspace (the AI-Native roadmap,
the Study/ pages, company-specific interview prep, the dashboard guides).
## The prime directive: teach, don't just present
A good page here is not a styled dump of notes. It makes a beginner *get it*. For every concept:
1. **Plain-English claim first.** One sentence, no jargon, the way you'd explain it to a smart
friend who's never seen it. ("RAG turns a closed-book exam into an open-book one.")
2. **A Feynman analogy.** A concrete everyday image that carries the mechanism (image=recipe,
container=the cooked meal; a skill's description = the spine label on a binder). Put it in a
`.analogy` aside.
3. **A diagram.** If the idea has structure, flow, or levels, *draw it* as inline SVG. A picture
replaces three paragraphs. (See `references/svg-diagrams.md`.)
4. **"Defend it cold" Q&A.** 2 to 4 `.qa` blocks: the hard questions the topic invites, answered so the
reader can CHECK whether he truly understands (could he re-derive this answer, closed-book, in his own
words?). Defend-cold means UNDERSTANDING deep enough that any question gets a real answer; it does NOT
mean rehearsing lines. The maintainer is studying to genuinely know the thing (the