--- name: explain-with-storytelling description: Use when asked to explain visually with storytelling. --- # Explain with Storytelling A scroll-driven story: short text steps on the left scroll past one sticky graphic on the right. As each step reaches the middle, the graphic changes to show it. On phones the kit pins the graphic at the top and the steps scroll under it. Best for the big picture before the details. ## Use this skill when - The user asks for a visual explanation of changes with storytelling. - Used by an orchestrator to explain changes visually with storytelling. ## Story - 5–7 steps, 1–2 short sentences each, one idea per step. Gloss each tool or term the first time it appears, in a few words in the same sentence ("tsgolint, Oxc's type-checking helper,"). - An arc: the situation today → what it costs → the change → the result → the catch → what to do first. - **One graphic** (one SVG) that evolves through all steps, and **every step changes something visible** on it (a bar appears, a value turns red, the counter moves, and the caption line always says what this step shows). Not a dashboard of every fact at once, and not a different picture per step. - **Don't redraw the hero.** The overview already shows the headline numbers; the story shows the thing they are about, and draws the catch on it: e.g. one bar per option split into carried over / lost / to fix, or the toolchain as boxes that get swapped one by one, with the broken part turning red or struck through. - It **fills its panel from step 1**: draw the whole frame (labels, empty tracks, axis) at rest and fill it in as the story goes, so there is never a small drawing in a large empty panel. - To scale and honest: bars on one scale share a unit and a base (seconds with seconds; counts out of different totals become each one's % of its own total, labelled "263 of 276"). Label things on the graphic itself. - Don't repeat the overview's numbers in every step, and don't append a details block; it ends when the story ends. ## Build it from this template (no script, no layout CSS) Copy it and change the labels, values and steps. It is a counter, to-scale rows whose empty tracks show from step 1, and a caption line that changes every step. Bar width = value ÷ largest × 240 (the track is 240 wide; values sit right of it). ```html
Today: one or two sentences.
…
38 s Build today (Webpack) Webpack 38 s Vite 6 s ! the catch, in a few words ✓ the first step to take
``` - The kit wires `data-ev-story`: for step n it sets `data-step="n"` on the panel and, inside it, shows `data-on` elements only on their steps (`2-4`, `3-` = from 3 on, `2,5`), adds `.is-hl` on `data-hl` steps and sets `data-say` text to the n-th item (`a|b||d`; an empty item keeps the previous text). Step 1's state is what the page shows at rest; scrolling back restores states exactly. Add a scoped `