[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75W72AXDQWJQB9ESBS22DPF":3,"skill-same:01M75W72AXDQWJQB9ESBS22DPF":65},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M75W72AXDQWJQB9ESBS22DPF","export",null,"Turn a finished demo into what people see outside a video player - a README bundle (a looping GIF, an animated WebP and a poster PNG plus a ready `\u003Cpicture>` snippet that sends reduced-motion readers the poster) and an interactive click-through HTML walkthrough built from the capture's lossless frames, one self-contained file that works offline. The loop is picked from the compose plan so it holds whole spotlights only; the walkthrough's hotspots come from the capture's mark rects. Use when asked to \"make a GIF of the demo\", \"put the demo in the README\", \"export a poster\", \"make an animated WebP\", \"make an interactive demo\", \"make a click-through walkthrough\", \"make an Arcade-style demo\", or \"share the demo without a video\". Reads demo:capture and demo:compose output only; it never films or renders.","stevengonsalvez\u002Fainb-toolkit","stevengonsalvez","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9320602?v=4","01M75W59QRYZYANWY3XG8CJB1P","Steven Gonsalvez","01M75W59RD5YW1RT67BDV0EAZF",1,"MIT","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: export\ndescription: Turn a finished demo into what people see outside a video player - a README bundle (a looping GIF, an animated WebP and a poster PNG plus a ready `\u003Cpicture>` snippet that sends reduced-motion readers the poster) and an interactive click-through HTML walkthrough built from the capture's lossless frames, one self-contained file that works offline. The loop is picked from the compose plan so it holds whole spotlights only; the walkthrough's hotspots come from the capture's mark rects. Use when asked to \"make a GIF of the demo\", \"put the demo in the README\", \"export a poster\", \"make an animated WebP\", \"make an interactive demo\", \"make a click-through walkthrough\", \"make an Arcade-style demo\", or \"share the demo without a video\". Reads demo:capture and demo:compose output only; it never films or renders.\n---\n\n# demo:export\n\nTwo exports from one composed demo. Film with demo:capture, cut with demo:compose, then:\n\n```\ncompose out\u002F\u003Cname>.mp4 ──┐\ncompose work\u002F*.plan.json ┼─▶ export.mjs readme ──▶ demo.gif + demo.webp + poster.png\n                         │                         picture.html, bundle.json\ncapture takes\u002F\u003Cch>\u002F      │\n  events.json (marks) ───┼─▶ export.mjs interactive ──▶ index.html (self-contained)\n  cfr\u002F%05d.png (2x) ─────┘                               steps.json\n```\n\n## Run\n\n```bash\nS=\"$SKILL_DIR\"   # this skill's own directory\nnode \"$S\u002Fscripts\u002Fexport.mjs\" readme      my.config.json   # compose\u002Fexport\u002Freadme\u002F\nnode \"$S\u002Fscripts\u002Fexport.mjs\" interactive my.config.json   # compose\u002Fexport\u002Finteractive\u002F\nnpm --prefix \"$S\" run check                               # self-check, ~48 s\n```\n\n`my.config.json` is the same file demo:compose ran on: the export reads the segment order, the\nplans in `\u003Cout>\u002Fwork\u002F`, the final `\u003Cout>\u002Fout\u002F\u003Cname>.mp4` and the takes it points at. Run it after\n`concat.sh`. On the compose skill's ferry example (`examples\u002Fferry\u002F`), after its quick start:\n\n```bash\nnode \"$S\u002Fscripts\u002Fexport.mjs\" readme ferry.config.json && node \"$S\u002Fscripts\u002Fexport.mjs\" interactive ferry.config.json\n```\n\nExit status is 2 for a bad command line (an unknown option, a value out of range), 1 for any\nother failure; every warning and error names its fix. ffmpeg is the config's `ffmpeg`, as in\ndemo:compose, else `$FFMPEG`, else `\u002Fusr\u002Fbin\u002Fffmpeg`, else the one on PATH.\n\n## readme: GIF, WebP, poster, snippet\n\n| option | default | |\n|---|---|---|\n| `--width` | 960 | output width in px (160 to 4096); height keeps the demo's aspect |\n| `--fps` | 15 | frame rate of the GIF and WebP (1 to 50) |\n| `--quality` | 90 | gifski quality to start from (1 to 100) |\n| `--budget` | 5 | size limit in MB for each of the GIF, WebP and poster |\n| `--from` \u002F `--to` | picked | loop range in seconds of the final mp4; must hold a whole spotlight |\n| `--out` | `\u003Cout>\u002Fexport\u002Freadme` | |\n\n**The loop.** One chapter, 8 to 12 s, starting and ending between spotlights so no spotlight is\ncut: each runs from its fade-in to the end of its fade-out, and the loop must hold all of it or\nnone. It leads 1.2 s before its first spotlight (the camera move into it is in the loop) and\ntails 0.6 s after its last. Compose crossfades close spotlights (one fades out as the next fades\nin), so a stretch that would start or end inside such an overlap is skipped; a chapter made only\nof crossfades longer than 12 s has no loop, and the export says to pass `--from`\u002F`--to`.\nCandidates score by spotlights held, closeness to 10 s, the seam (mean luma difference between\nthe first and last frame) and the motion at either end (luma change over the first and last\n1\u002F15 s), so the restart neither jumps nor stops mid zoom. A `--from`\u002F`--to` that cuts a\nspotlight, or holds none, is refused before anything is encoded.\n\n**GIF** via gifski when installed (libimagequant, temporal dithering). Without it the export\nwarns once and uses ffmpeg `palettegen=stats_mode=diff` + `paletteuse=dither=bayer:bayer_scale=3`,\ncoarser on gradients. Install: `brew install gifski` or `cargo install gifski`. Over budget,\nthe export steps gifski's quality down by 10 to 60 (the ffmpeg palette has no quality knob), then\nwidth down by 160 to 640 (or to `--width`, when that is smaller), then fails. The WebP and the\nposter are held to the same budget. The snippet carries the size the GIF came out at, read from\nits header, so a square demo gets a square `\u003Cimg>`. On the\nferry loop the ffmpeg fallback is 5.024 MB at 960 px, just over budget, so it steps to 800 px:\n3.868 MB, 18.0 s.\n\n**WebP** via ffmpeg's `libwebp_anim` when the build has it, else `img2webp` (libwebp's own\ntool, the `webp` package). Ubuntu's ffmpeg 6.1 has libwebp; Homebrew's ffmpeg 9 does not, so\nthere `img2webp` makes it (q75, method 4). With neither, the snippet offers the GIF only and\nsays so. Encoders merge unchanged frames into longer ones, so a 151-frame loop holds 111 WebP\nand 140 GIF frames and still plays 10.07 to 10.12 s.\n\n**Poster**: the loop's last spotlight, fully lit: after both the cut-out's fade-in and its\nlabel's (compose starts the label at the mark minus 0.1 x pace and runs it 0.3 x pace), before\nits fade-out.\n\n**Snippet** (`picture.html`), paste into a README or page beside the three files:\n\n```html\n\u003Cpicture>\n  \u003Csource media=\"(prefers-reduced-motion: reduce)\" srcset=\"poster.png\">\n  \u003Csource type=\"image\u002Fwebp\" srcset=\"demo.webp\">\n  \u003Cimg src=\"demo.gif\" width=\"960\" height=\"540\" alt=\"The live board: Next sailing runs late, Six car spaces left, Four sailings, status each\">\n\u003C\u002Fpicture>\n```\n\nThe alt text is the chapter title and the labels the loop shows.\n\nMeasured on the ferry example (30.2 s final, 1280x720), gifski 1.34, libwebp 1.6, defaults:\n\n| | ffmpeg 6.1 (libwebp) | ffmpeg 9 + img2webp |\n|---|---|---|\n| loop picked | departures, 5.492 to 15.508 s | same |\n| demo.gif | 3.369 MB (gifski q90, 960 px) | same |\n| demo.webp | 1.152 MB | 1.212 MB |\n| poster.png | 0.101 MB, at 13.358 s | 0.109 MB |\n| wall time | 16.0 s | 13.9 to 16.5 s |\n\nThe loop holds 3 spotlights in 10.0 s (151 frames at 15 fps). Its ends move 0.89 (luma change,\nof 255, summed over both ends); ends placed mid camera move on this demo measure 6 to 25, so\nthe motion weight (0.5) costs such a loop 3 to 12 points against 10 per spotlight held.\n\n## interactive: click-through walkthrough\n\n| option | default | |\n|---|---|---|\n| `--payoff` | last step | label (prefix) of the step that shows the payoff; linted |\n| `--inline` | `auto` | `yes` embeds the images, `no` writes them beside the page; `auto` embeds up to 12 MB |\n| `--out` | `\u003Cout>\u002Fexport\u002Finteractive` | |\n\n**Steps.** One per mark in demo order (every mark has a rect and a label), plus each click or\ntype cue with a target (demo:capture records the clicked or typed-into element's rect and the\ncamera box on each). A type beat is filmed as a click into the field then the type cue; the two\nmake one step at the click's frame and rect (the field before it widened or hid). Cue steps are\nlabelled from the target's accessible name and role as demo:capture recorded them: \"Open Fares\"\nfor a link, \"Click Save\" otherwise, \"Type in Search\" for a field; takes filmed before names were\nrecorded read \"Click here\" and \"Type here\". Cues that point at nothing are not steps, each case said in a\nwarning: no `rect` at all (the take predates demo:capture recording targets: re-film it),\n`rect: null` (the target had no box when filmed: display:none or zero size), or a rect wholly\noutside its frame (below the fold, outside the camera box). The label is the narration line for that\nmark when the demo has narration, else compose's label for that spotlight (so the config's\n`labels` overrides apply), else the capture's, cut at a word to under 60 characters\n(longer hotspot copy loses about 12% completion in Arcade's benchmarks).\n\n**Step images** come from the lossless take, never the lossy final: the frame at the mark from\n`takes\u002F\u003Cch>\u002Fcfr\u002F`, else decoded from the take's mp4 (seeking half a frame early, so a 60 fps\ntake gives the marked frame and not the next), at the take's own density (2560x1440 for a\ndeterministic 2x take). Stored as WebP q90 (ffmpeg libwebp, else `cwebp`), else PNG with a\nwarning to install the `webp` package. Ferry: 0.307 MB of WebP for five steps against 0.829 MB\nof PNG. Each run first removes the step images, page and `steps.json` an earlier run left.\n\n**Hotspots**: the mark rect in page CSS px, through the camera box in force at the mark\n(zoom `s`, origin `x`,`y`), times the take's density, fitted to the frame's real size from its\nPNG header and clipped to it. A mark wholly outside its frame fails the export (a mark is\nwhat the demo is about); a click or type is dropped instead, as above.\n\n**The page**: one HTML file, no network. Hotspot with a pulsing ring (still under\n`prefers-reduced-motion`); its label sits below it, else above, else inside its lower edge\n(a hotspot as tall as the frame), measured at the rendered size so it never leaves the frame.\nBack\u002FNext (Next becomes Start over on the last step, as does the last hotspot), progress dots\nwith 24 px targets (`aria-current=\"step\"`), step count, a live region announcing each label.\nEnds use `aria-disabled`, so keyboard focus stays put. Keys: Right or Enter next, Left back,\nHome, End. Visible focus ring on every control (`:focus-visible`). Works from 390 px wide up.\n\n**Lint** (warnings, not failures): fewer than 9 or more than 12 steps (Arcade: 9 to 12 finish\nmost often), and a payoff after step 7 (most viewers have left by then).\n\nMeasured on the ferry example, filmed with the current demo:capture: 6 steps (3 departures\nmarks; in fares the click on the Fares nav link, then 2 marks), images inlined (0.401 MB),\n`index.html` 0.542 MB, 2.4 s. Takes filmed before click targets were recorded give 5 steps and\nwarn about the skipped click (0.417 MB, 1.4 to 2.2 s). Checked with Playwright at 1280 and 390\nwide: every hotspot and label inside its step image (also with a hotspot as tall as the frame,\nand one 8% tall at the top), stepped through by hotspot clicks and Right alternately; Left,\nHome, End, Start over and Enter on a focused control all land on the right step, focus stays on\nBack at step 1, dots measure 24 px, no console errors, no horizontal scroll.\n\n## Self-check\n\n`npm run check` (no dependencies; ffmpeg and the encoders above). It fails if:\n\n- the loop picker cuts a spotlight or leaves the chapter's footage, over 3000 random chapters\n  with crossfading neighbours, or on seven spotlights that all crossfade;\n- a hotspot lands outside its step image (5000 random boxes through `clipTo`, then an end-to-end\n  export whose step images are measured against their boxes, and a mark off screen that must fail);\n- a GIF over its budget gets through, the width steps below 640 px, or a `--from`\u002F`--to` that cuts\n  a spotlight or holds none is accepted (the last before anything is encoded);\n- the snippet's size differs from the GIF's, 16:9 or square;\n- a step from a 60 fps take shows the frame after its mark (frames 1, 4 and 7, each its own grey);\n- a step label is the capture's when compose has one, a step image from an earlier run survives,\n  the poster lands before the label is in at pace 3, the config's `ffmpeg` is ignored, or a\n  misspelt option, non-number or bad choice runs instead of exiting 2.\n\nThe end-to-end part builds a synthetic demo (ffmpeg `testsrc2`) in a temp directory whose name\nholds a space and `%`, and runs both exports on it. Each guard was checked by breaking it: the\nmatching check goes red.\n\n## Limits\n\n- demo:export reads demo:compose's config loader from `..\u002Fcompose\u002Fscripts\u002F`, so it runs from\n  the plugin's `skills\u002F` directory with compose beside it, as the plugin installs it.\n- Click and type steps say only what the target is called (\"Open Fares\"), not why. Put a mark\n  on anything that needs words.\n- The loop stays inside one chapter; a demo whose chapters are all shorter than 8 s gets a\n  shorter loop and a warning.\n- Hotspots are rectangles; a rotated or clipped element shows its bounding box.\n","# demo:export\n\nTwo exports from one composed demo. Film with demo:capture, cut with demo:compose, then:\n\n```\ncompose out\u002F\u003Cname>.mp4 ──┐\ncompose work\u002F*.plan.json ┼─▶ export.mjs readme ──▶ demo.gif + demo.webp + poster.png\n                         │                         picture.html, bundle.json\ncapture takes\u002F\u003Cch>\u002F      │\n  events.json (marks) ───┼─▶ export.mjs interactive ──▶ index.html (self-contained)\n  cfr\u002F%05d.png (2x) ─────┘                               steps.json\n```\n\n## Run\n\n```bash\nS=\"$SKILL_DIR\"   # this skill's own directory\nnode \"$S\u002Fscripts\u002Fexport.mjs\" readme      my.config.json   # compose\u002Fexport\u002Freadme\u002F\nnode \"$S\u002Fscripts\u002Fexport.mjs\" interactive my.config.json   # compose\u002Fexport\u002Finteractive\u002F\nnpm --prefix \"$S\" run check                               # self-check, ~48 s\n```\n\n`my.config.json` is the same file demo:compose ran on: the export reads the segment order, the\nplans in `\u003Cout>\u002Fwork\u002F`, the final `\u003Cout>\u002Fout\u002F\u003Cname>.mp4` and the takes it points at. Run it after\n`concat.sh`. On the compose skill's ferry example (`examples\u002Fferry\u002F`), after its quick start:\n\n```bash\nnode \"$S\u002Fscripts\u002Fexport.mjs\" readme ferry.config.json && node \"$S\u002Fscripts\u002Fexport.mjs\" interactive ferry.config.json\n```\n\nExit status is 2 for a bad command line (an unknown option, a value out of range), 1 for any\nother failure; every warning and error names its fix. ffmpeg is the config's `ffmpeg`, as in\ndemo:compose, else `$FFMPEG`, else `\u002Fusr\u002Fbin\u002Fffmpeg`, else the one on PATH.\n\n## readme: GIF, WebP, poster, snippet\n\n| option | default | |\n|---|---|---|\n| `--width` | 960 | output width in px (160 to 4096); height keeps the demo's aspect |\n| `--fps` | 15 | frame rate of the GIF and WebP (1 to 50) |\n| `--quality` | 90 | gifski quality to start from (1 to 100) |\n| `--budget` | 5 | size limit in MB for each of the GIF, WebP and poster |\n| `--from` \u002F `--to` | picked | loop range in seconds of the final mp4; must hold a whole spotlight |\n| `--out` | `\u003Cout>\u002Fexport\u002Freadme` | |\n\n**The loop.** One chapter, 8 to 12 s, starting and ending between spotlights so no spotlight is\ncut: each runs from its fade-in to the end of its fade-out, and the loop must hold all of it or\nnone. It leads 1.2 s before its first spotlight (the camera move into it is in the loop) and\ntails 0.6 s after its last. Compose crossfades close spotlights (one fades out as the next fades\nin), so a stretch that would start or end inside such an overlap is skipped; a chapter made only\nof crossfades longer than 12 s has no loop, and the export says to pass `--from`\u002F`--to`.\nCandidates score by spotlights held, closeness to 10 s, the seam (mean luma difference between\nthe first and last frame) and the motion at either end (luma change over the first and last\n1\u002F15 s), so the restart neither jumps nor stops mid zoom. A `--from`\u002F`--to` that cuts a\nspotlight, or holds none, is refused before anything is encoded.\n\n**GIF** via gifski when installed (libimagequant, temporal dithering). Without it the export\nwarns once and uses ffmpeg `palettegen=stats_mode=diff` + `paletteuse=dither=bayer:bayer_scale=3`,\ncoarser on gradients. Install: `brew install gifski` or `cargo install gifski`. Over budget,\nthe export steps gifski's quality down by 10 to 60 (the ffmpeg palette has no quality knob), then\nwidth down by 160 to 640 (or to `--width`, when that is smaller), then fails. The WebP and the\nposter are held to the same budget. The snippet carries the size the GIF came out at, read from\nits header, so a square demo gets a square `\u003Cimg>`. On the\nferry loop the ffmpeg fallback is 5.024 MB at 960 px, just over budget, so it steps to 800 px:\n3.868 MB, 18.0 s.\n\n**WebP** via ffmpeg's `libwebp_anim` when the build has it, else `img2webp` (libwebp's own\ntool, the `webp` package). Ubuntu's ffmpeg 6.1 has libwebp; Homebrew's ffmpeg 9 does not, so\nthere `img2webp` makes it (q75, method 4). With neither, the snippet offers the GIF only and\nsays so. Encoders merge unchanged frames into longer ones, so a 151-frame loop holds 111 WebP\nand 140 GIF frames and still plays 10.07 to 10.12 s.\n\n**Poster**: the loop's last spotlight, fully lit: after both the cut-out's fade-in and its\nlabel's (compose starts the label at the mark minus 0.1 x pace and runs it 0.3 x pace), before\nits fade-out.\n\n**Snippet** (`picture.html`), paste into a README or page beside the three files:\n\n```html\n\u003Cpicture>\n  \u003Csource media=\"(prefers-reduced-motion: reduce)\" srcset=\"poster.png\">\n  \u003Csource type=\"image\u002Fwebp\" srcset=\"demo.webp\">\n  \u003Cimg src=\"demo.gif\" width=\"960\" height=\"540\" alt=\"The live board: Next sailing runs late, Six car spaces left, Four sailings, status each\">\n\u003C\u002Fpicture>\n```\n\nThe alt text is the chapter title and the labels the loop shows.\n\nMeasured on the ferry example (30.2 s final, 1280x720), gifski 1.34, libwebp 1.6, defaults:\n\n| | ffmpeg 6.1 (libwebp) | ffmpeg 9 + img2webp |\n|---|---|---|\n| loop picked | departures, 5.492 to 15.508 s | same |\n| demo.gif | 3.369 MB (gifski q90, 960 px) | same |\n| demo.webp | 1.152 MB | 1.212 MB |\n| poster.png | 0.101 MB, at 13.358 s | 0.109 MB |\n| wall time | 16.0 s | 13.9 to 16.5 s |\n\nThe loop holds 3 spotlights in 10.0 s (151 frames at 15 fps). Its ends move 0.89 (luma change,\nof 255, summed over both ends); ends placed mid camera move on this demo measure 6 to 25, so\nthe motion weight (0.5) costs such a loop 3 to 12 points against 10 per spotlight held.\n\n## interactive: click-through walkthrough\n\n| option | default | |\n|---|---|---|\n| `--payoff` | last step | label (prefix) of the step that shows the payoff; linted |\n| `--inline` | `auto` | `yes` embeds the images, `no` writes them beside the page; `auto` embeds up to 12 MB |\n| `--out` | `\u003Cout>\u002Fexport\u002Finteractive` | |\n\n**Steps.** One per mark in demo order (every mark has a rect and a label), plus each click or\ntype cue with a target (demo:capture records the clicked or typed-into element's rect and the\ncamera box on each). A type beat is filmed as a click into the field then the type cue; the two\nmake one step at the click's frame and rect (the field before it widened or hid). Cue steps are\nlabelled from the target's accessible name and role as demo:capture recorded them: \"Open Fares\"\nfor a link, \"Click Save\" otherwise, \"Type in Search\" for a field; takes filmed before names were\nrecorded read \"Click here\" and \"Type here\". Cues that point at nothing are not steps, each case said in a\nwarning: no `rect` at all (the take predates demo:capture recording targets: re-film it),\n`rect: null` (the target had no box when filmed: display:none or zero size), or a rect wholly\noutside its frame (below the fold, outside the camera box). The label is the narration line for that\nmark when the demo has narration, else compose's label for that spotlight (so the config's\n`labels` overrides apply), else the capture's, cut at a word to under 60 characters\n(longer hotspot copy loses about 12% completion in Arcade's benchmarks).\n\n**Step images** come from the lossless take, never the lossy final: the frame at the mark from\n`takes\u002F\u003Cch>\u002Fcfr\u002F`, else decoded from the take's mp4 (seeking half a frame early, so a 60 fps\ntake gives the marked frame and not the next), at the take's own density (2560x1440 for a\ndeterministic 2x take). Stored as WebP q90 (ffmpeg libwebp, else `cwebp`), else PNG with a\nwarning to install the `webp` package. Ferry: 0.307 MB of WebP for five steps against 0.829 MB\nof PNG. Each run first removes the step images, page and `steps.json` an earlier run left.\n\n**Hotspots**: the mark rect in page CSS px, through the camera box in force at the mark\n(zoom `s`, origin `x`,`y`), times the take's density, fitted to the frame's real size from its\nPNG header and clipped to it. A mark wholly outside its frame fails the export (a mark is\nwhat the demo is about); a click or type is dropped instead, as above.\n\n**The page**: one HTML file, no network. Hotspot with a pulsing ring (still under\n`prefers-reduced-motion`); its label sits below it, else above, else inside its lower edge\n(a hotspot as tall as the frame), measured at the rendered size so it never leaves the frame.\nBack\u002FNext (Next becomes Start over on the last step, as does the last hotspot), progress dots\nwith 24 px targets (`aria-current=\"step\"`), step count, a live region announcing each label.\nEnds use `aria-disabled`, so keyboard focus stays put. Keys: Right or Enter next, Left back,\nHome, End. Visible focus ring on every control (`:focus-visible`). Works from 390 px wide up.\n\n**Lint** (warnings, not failures): fewer than 9 or more than 12 steps (Arcade: 9 to 12 finish\nmost often), and a payoff after step 7 (most viewers have left by then).\n\nMeasured on the ferry example, filmed with the current demo:capture: 6 steps (3 departures\nmarks; in fares the click on the Fares nav link, then 2 marks), images inlined (0.401 MB),\n`index.html` 0.542 MB, 2.4 s. Takes filmed before click targets were recorded give 5 steps and\nwarn about the skipped click (0.417 MB, 1.4 to 2.2 s). Checked with Playwright at 1280 and 390\nwide: every hotspot and label inside its step image (also with a hotspot as tall as the frame,\nand one 8% tall at the top), stepped through by hotspot clicks and Right alternately; Left,\nHome, End, Start over and Enter on a focused control all land on the right step, focus stays on\nBack at step 1, dots measure 24 px, no console errors, no horizontal scroll.\n\n## Self-check\n\n`npm run check` (no dependencies; ffmpeg and the encoders above). It fails if:\n\n- the loop picker cuts a spotlight or leaves the chapter's footage, over 3000 random chapters\n  with crossfading neighbours, or on seven spotlights that all crossfade;\n- a hotspot lands outside its step image (5000 random boxes through `clipTo`, then an end-to-end\n  export whose step images are measured against their boxes, and a mark off screen that must fail);\n- a GIF over its budget gets through, the width steps below 640 px, or a `--from`\u002F`--to` that cuts\n  a spotlight or holds none is accepted (the last before anything is encoded);\n- the snippet's size differs from the GIF's, 16:9 or square;\n- a step from a 60 fps take shows the frame after its mark (frames 1, 4 and 7, each its own grey);\n- a step label is the capture's when compose has one, a step image from an earlier run survives,\n  the poster lands before the label is in at pace 3, the config's `ffmpeg` is ignored, or a\n  misspelt option, non-number or bad choice runs instead of exiting 2.\n\nThe end-to-end part builds a synthetic demo (ffmpeg `testsrc2`) in a temp directory whose name\nholds a space and `%`, and runs both exports on it. Each guard was checked by breaking it: the\nmatching check goes red.\n\n## Limits\n\n- demo:export reads demo:compose's config loader from `..\u002Fcompose\u002Fscripts\u002F`, so it runs from\n  the plugin's `skills\u002F` directory with compose beside it, as the plugin installs it.\n- Click and type steps say only what the target is called (\"Open Fares\"), not why. Put a mark\n  on anything that needs words.\n- The loop stays inside one chapter; a demo whose chapters are all shorter than 8 s gets a\n  shorter loop and a warning.\n- Hotspots are rectangles; a rotated or clipped element shows its bounding box.\n",{"name":5,"description":7},"main","9cf32d1e636db09530158af14ba301bfa5d401e9","plugins\u002Fdemo\u002Fskills\u002Fexport","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez","stevengonsalvez.com","2026-11-12 00:50:59",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add stevengonsalvez\u002Fainb-toolkit --skill export",{"tool":37,"command":38},"bunx","bunx skills add stevengonsalvez\u002Fainb-toolkit --skill export",{"tool":40,"command":41},"pnpm","pnpm dlx skills add stevengonsalvez\u002Fainb-toolkit --skill export","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002FSKILL.md",true,[45,51,57,61],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"package.json","REFERENCE","参考文档",129,"https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002Fpackage.json",{"path":52,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":55,"sourceHtmlUrl":56},"scripts\u002Fexport.mjs","SCRIPT","脚本",21524,"https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002Fscripts\u002Fexport.mjs",{"path":58,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":59,"sourceHtmlUrl":60},"scripts\u002Flib.mjs",11317,"https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002Fscripts\u002Flib.mjs",{"path":62,"resourceType":53,"resourceTypeDesc":54,"sizeBytes":63,"sourceHtmlUrl":64},"scripts\u002Fselfcheck.mjs",16212,"https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fdemo\u002Fskills\u002Fexport\u002Fscripts\u002Fselfcheck.mjs",[66,73,80,86,93,100],{"skillNo":67,"name":68,"nameZh":6,"description":69,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":70,"categories":71,"keywords":72,"publishedAt":19},"01M75WK9B8DKVJBJJ4CX2QMJMX","well-formed","Fixture skill that satisfies every mechanical rule, used to prove the conformance check passes a clean tree instead of failing everything.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fclean\u002Fwell-formed\u002FSKILL.md",[],[],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M75WK6ZGDXJJN8879K49QEYG","underscore-tools","Fixture skill that spells the tool allowlist key with an underscore instead of the hyphen the spec requires.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Funderscore-tools\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M75WK524MVT2H9E27ZCEA3HR","no-frontmatter","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fno-frontmatter\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M75WJWZBMKR8R60PG3T3MCCC","long-description","Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling. Fixture skill with a deliberately oversized description used to prove the conformance check rejects anything past the 1024 character ceiling.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Flong-description\u002FSKILL.md",[],[],{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M75WJVRH3J22WKED7E5D01S8","some-other-name","Fixture skill whose frontmatter name does not match its parent directory name.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fdir-mismatch\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":106,"publishedAt":19},"01M75WJTC7H5FRP6S129VBSMZC","bad_Name","Fixture skill whose name uses an underscore and a capital letter, so it violates the agentskills.io name pattern.","https:\u002F\u002Fgithub.com\u002Fstevengonsalvez\u002Fainb-toolkit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fagentskills\u002Fbroken\u002Fbad_Name\u002FSKILL.md",[],[]]