Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Education

learn-visual

Make a teaching diagram (usually SVG) for one idea, look at it, and fix it until the picture actually shows the claim. Use when the user runs /learn-visual or /skill:learn-visual, or asks for a figure, diagram, SVG, sketch, visualization, or picture of a concept being taught.

vasanthsreeram · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add vasanthsreeram/Alvarmethod --skill learn-visual

About this skill


name: learn-visual description: > Make a teaching diagram (usually SVG) for one idea, look at it, and fix it until the picture actually shows the claim. Use when the user runs /learn-visual or /skill:learn-visual, or asks for a figure, diagram, SVG, sketch, visualization, or picture of a concept being taught. license: MIT metadata: author: vasanthsreeram version: "1.0" source: "Eero Alvar — How I Use AI to Learn Things https://youtu.be/kzcI5F4tGiU"

Learn visual

One idea, one picture. The picture exists so the learner can accept the step — not as decoration.

Output

Write .alvar/visuals/<slug>-<n>.svg (create the folder). Embed or link it in the session file.

Prefer SVG. Use another format only if the harness cannot preview SVG.

Loop (do not skip)

  1. State the claim the picture must make, in one sentence.
  2. Draw the smallest picture that makes that claim.
  3. Look at the file (image/read tool). If you cannot view it, say so and keep the SVG simple enough to audit as text.
  4. Fix labels, overlap, wrong arrows, missing units, or a picture that does not match the claim.
  5. Look again. Stop after a clean pass, not after the first draft.

Design

  • One claim. No collage of the whole course.
  • Large labels. High contrast. No tiny legend the learner needs a second lesson to read.
  • If the idea is algebraic, show the objects (arrows, planes, machines), not a screenshot of the equation.
  • Do not add decorative gradients, watermarks, or "AI art" backgrounds.

Failures to catch on the look pass

  • Arrow direction disagrees with the prose
  • Two symbols for the same object
  • 3D that hides the relation
  • Cropped text
  • A picture of a different special case than the one just taught

After

Tell the learner what to look at first ("the two arrows, then the pairing number"). Do not re-teach the whole node unless they ask.