learn-visual

Original：🇺🇸 English

Translated

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.

5installs

Sourcevasanthsreeram/alvarmethod

Added on2026-08-17

NPX Install

npx skill4agent add vasanthsreeram/alvarmethod learn-visual

SKILL.md Content

View Translation Comparison →

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)

State the claim the picture must make, in one sentence.
Draw the smallest picture that makes that claim.
Look at the file (image/read tool). If you cannot view it, say so and keep the SVG simple enough to audit as text.
Fix labels, overlap, wrong arrows, missing units, or a picture that does not match the claim.
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.