visual-learner
Installation
SKILL.md
Visual Learner
Create an interactive HTML explainer that lets the reader understand by doing. Prefer a portable single-file artifact unless the user asks for a larger app. The artifact must behave like an instrument, simulator, map, or game board; a beautiful article with buttons is not enough.
Workflow
- Identify the learning goal in one sentence: what should the reader remember or be able to explain after the artifact?
- Research the topic enough to avoid shallow metaphors. For current facts, libraries, APIs, laws, prices, or examples, browse primary or official sources and cite them in the final response.
- Choose the smallest fitting explainer shape:
- Reactive document for assumptions, formulas, tradeoffs, policy, finance, or scientific claims.
- Explorable example for algorithms, math, physics, architecture, and causal mechanisms.
- Simulation for feedback loops, emergent behavior, queues, networks, social dynamics, and probabilistic systems.
- Scrollytelling for stepwise arguments, timeline narratives, or data journalism.
- Small game for strategy, incentives, negotiation, memory, classification, or concepts where consequences teach better than prose.
- Define the load-bearing model before layout: state variables, rules/formulas, reader actions, visual consequences, and the intended surprise or memory hook.
- Design from concrete to abstract. Start with a direct interaction in the first viewport; introduce terms only after the reader has manipulated or observed the system.
- Build the artifact. Default to one
.htmlfile with inline CSS and JS, no build step, and CDN dependencies only when they materially reduce risk. - Verify the artifact in a browser when possible. Check desktop and mobile layout, no overlapping text, meaningful interaction states, accessible labels, and nonblank visuals.
- Final response: link the artifact path, summarize the explainer model, list verification performed, and mention any source or test gaps.