Andrew Shiau

Explain

Type
Agent skill

A skill that turns something I just worked out — an incident, a system, a recipe — into one self-contained explainer: a diagram, and a short quiz that checks whether the idea landed.

Why the quiz

Writing something down proves I can phrase it. It doesn’t tell me whether anyone understood it. Three questions a reader gets right does, so every explainer this skill writes ends in a quiz.

One prompt produces both halves, in one self-contained HTML file.

Both examples below are live.Answer a quiz question — correct gets a ✓ and the accent rule, wrong gets an ✕.
10x is a loop, not a prompt — the diagram and the quiz, live in the frame

Explainers

Form
One prompt in, one self-contained HTML file out: the explanation, a diagram, and a scored quiz. The three on this site are set in the site's own system; the skill emits its own styles for anywhere else.
The test
If a reader can’t pass the quiz, I rewrite the explainer. It’s the only check the skill makes.