[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M74FN9FFMJ50X8Z9H08ZG09T":3,"skill-same:01M74FN9FFMJ50X8Z9H08ZG09T":72},{"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":33,"commitSha":34,"skillDirectory":35,"forksCount":36,"repositoryHtmlUrl":37,"repositoryHomepageUrl":6,"ownerHtmlUrl":38,"ownerBlogUrl":39,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M74FN9FFMJ50X8Z9H08ZG09T","vhs-demo",null,"Creates and maintains a scripted, reproducible terminal-demo GIF for a CLI repo from a Charm VHS tape rendered headless via Docker — the .tape is the committed source of truth, the GIF a regenerated artifact. Use when the user wants to add, record, regenerate or tweak a terminal demo GIF for a kirchDev CLI repo (citty\u002FBun tools like envprism, forgemap), or asks about VHS tapes, demo.gif, README terminal previews, or terminal captures for docs pages. Do not use for editing or optimising arbitrary existing GIFs.","TitusKirch\u002Fskills","TitusKirch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F16943133?v=4","01M74FN1AAM5K2NH5EG292B2HZ","Titus Kirch","01M74FN1AX7TX6RAECBHE5PMNT",3,"MIT","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fvhs-demo\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: vhs-demo\nmetadata:\n  summary: Creates and maintains reproducible README or docs terminal-demo GIFs from VHS tapes.\ndescription: Creates and maintains a scripted, reproducible terminal-demo GIF for a CLI repo from a Charm VHS tape rendered headless via Docker — the .tape is the committed source of truth, the GIF a regenerated artifact. Use when the user wants to add, record, regenerate or tweak a terminal demo GIF for a kirchDev CLI repo (citty\u002FBun tools like envprism, forgemap), or asks about VHS tapes, demo.gif, README terminal previews, or terminal captures for docs pages. Do not use for editing or optimising arbitrary existing GIFs.\nallowed-tools:\n  - Read\n  - Write\n  - Edit\n  - Bash\n  - Glob\n  - Grep\n---\n\n# vhs-demo\n\nGenerate a terminal-demo GIF from a [Charm VHS](https:\u002F\u002Fgithub.com\u002Fcharmbracelet\u002Fvhs) tape, rendered headless in Docker. The tape is committed; the GIF is a build artifact regenerated from it.\n\n> [!IMPORTANT]\n> **The tape is the source of truth.** Always edit the `.tape` and re-render. Never hand-edit, re-time, or recompress the GIF — it cannot be reproduced and the next render will overwrite it.\n\n## Why Docker\n\nVHS normally wants a real TTY (and on macOS, Homebrew + sometimes a screen recorder). The template builds a headless renderer on a digest-pinned Node\u002FDebian base, installs current Chromium\u002Fffmpeg packages and checksum-verified Bun, builds checksum-pinned VHS source with a patched Go toolchain and network dependency, and builds ttyd against current system libraries. It works in WSL\u002Froot environments with no Homebrew, no TTY, no OBS. Docker is the only host dependency; supported targets are `linux\u002Famd64` and `linux\u002Farm64`.\n\n## Destination & naming convention\n\nResolve the intended **README or docs context before scaffolding**. An optional caller such as `write-docs` passes the target page, context, repo-relative output path, subject\u002Fref and any required language variant; honor that target. Without a target, keep the README default.\n\n- **README demo** → paired tape + GIF under `.github\u002Fassets\u002F`.\n- **Docs demo** → paired tape + GIF under `docs\u002F_assets\u002F`. This is a non-section directory: no numeric prefix, `index.md` or navigation entry.\n- **One demo at the selected destination** → `demo.tape` \u002F `demo.gif`; **multiple demos** → descriptive paired base names, e.g. `quickstart.tape` \u002F `quickstart.gif` or `ci.tape` \u002F `ci.gif`. Honor an explicit output name even for the first demo.\n- **Shared media** → reuse an existing artifact when README and docs show the same demo; do not create a second copy solely to embed it elsewhere.\n- **Language-dependent demos** → explicitly capture and verify variants when needed, e.g. `docs\u002F_assets\u002Fde-DE\u002Fquickstart.tape` \u002F `quickstart.gif`. Shared language-neutral media is referenced across locale pages. Translate alt text and captions; a translation sweep never produces captures.\n- **The Dockerfile stays generic**: `.github\u002Fassets\u002Fvhs.Dockerfile`, shared by both destinations — never named after a demo.\n\nConsumer-specific tapes and regenerated GIFs belong in the consumer repo, never in the published skill. The paired tape is committed, but only the GIF is published as docs media; tapes, scripts and Dockerfiles are not image outputs.\n\n## Quick start\n\n1. **Resolve the target** and set repo-relative paths once. README default:\n   ```bash\n   tape=.github\u002Fassets\u002Fdemo.tape\n   gif=.github\u002Fassets\u002Fdemo.gif\n   ```\n   Docs example:\n   ```bash\n   tape=docs\u002F_assets\u002Fquickstart.tape\n   gif=docs\u002F_assets\u002Fquickstart.gif\n   ```\n   These variables stay set for render and verification commands below; do not use the default README path after selecting a docs target.\n2. **Scaffold** `.github\u002Fassets\u002Fvhs.Dockerfile` from [`templates\u002Fvhs.Dockerfile`](templates\u002Fvhs.Dockerfile). Reuse it when already present; keep or drop the Bun layer (see below).\n3. **Scaffold** the selected tape from [`templates\u002Fdemo.tape`](templates\u002Fdemo.tape), set its `Output` to the exact selected `gif` path, and write the choreography for this CLI. The template's `Output` is the README default and must be replaced for docs, named or localized targets.\n4. **Build the CLI** so the tape runs the built artifact, not the sources: run the repo's build (e.g. `pnpm build` \u002F `bun run build`).\n5. **Build the image** (once, or after editing the Dockerfile):\n   ```bash\n   docker build --pull --no-cache -f .github\u002Fassets\u002Fvhs.Dockerfile -t \u003Crepo>-vhs .\n   ```\n6. **Render** (after every tape change), from the consumer repo root:\n   ```bash\n   docker run --rm --cap-drop=ALL --security-opt no-new-privileges:true \\\n     -v \"$PWD:\u002Fvhs\" \u003Crepo>-vhs \"$tape\"\n   ```\n7. **Verify** the selected GIF (dimensions, duration ≈ sum of sleeps, file size, captured content) — see [Verification](#verification). A committed tape establishes reproducibility, not freshness; render against the intended CLI\u002Fref and check the result.\n8. **Wire the target page's image reference** and commit the tape, shared Dockerfile and regenerated GIF together. Report the source path, verified output path, subject\u002Fref and reference to the caller. The writing skill owns page inclusion and layout.\n\n## Does the CLI need Bun?\n\nThe template includes a **version-pinned Bun layer** for CLIs using `opentui`, `bun:ffi`, or `bun …`. The archive is checked against its pinned SHA-256 before installation; the amd64 build uses Bun's baseline binary. A Bun version change must update both architecture checksums together. No downloaded installer script is executed.\n\n- **Bun CLI** → keep the Bun layer in `templates\u002Fvhs.Dockerfile`.\n- **Node CLI** (plain citty, run with `node …`) → delete the Bun layer; the image already has Node. npm\u002Fnpx are removed from the renderer; install dependencies and build the CLI on the host before rendering.\n\n## Resolution & render quality\n\nDefaults baked into the tape template:\n\n| Setting         | Default (Full HD) | Lighter alternative |\n| :-------------- | :---------------- | :------------------ |\n| `Set Width`     | `1920`            | `1280`              |\n| `Set Height`    | `1080`            | `720`               |\n| `Set FontSize`  | `20`              | `16`                |\n| `Set Padding`   | `16`              | `16`                |\n| `Set Framerate` | `24`              | `24`                |\n\n> [!IMPORTANT]\n> **Cap the framerate.** At 1080p a busy TUI usually can't repaint fast enough to sustain VHS's default **50fps** capture. VHS then drops frames, the GIF plays too fast \u002F janky, and the measured duration is _shorter_ than the sum of your `Sleep`s. `Set Framerate 24` caps the capture rate to something the TUI can actually hold. If verification still shows the duration running short, lower the framerate further (20, then 16) and re-render.\n\nUse the lighter 1280×720 @ FontSize 16 profile when the GIF needs to be smaller\u002Fcheaper to load and Full HD detail isn't essential.\n\n## Pitfalls — do's & don'ts\n\n- **`Output` path MUST be relative** (e.g. `.github\u002Fassets\u002Fdemo.gif` or `docs\u002F_assets\u002Fquickstart.gif`). An absolute path like `\u002Fvhs\u002F...` is rejected by the VHS parser.\n- **Build the CLI first** — run the repo's build (e.g. `pnpm build` \u002F `bun run build`). The tape launches the built artifact (`dist\u002F…`), not the source.\n- **Bun CLIs need the Bun image layer** — see above.\n- **Work on a throwaway copy of fixtures** if the demo edits\u002Fwrites files. Copy them to `\u002Ftmp` inside the hidden `Hide … Show` block so the working tree stays clean (e.g. `cp -r \u002Fvhs\u002Fexamples \u002Ftmp\u002Fdemo`).\n- **Clear pre-filled edit fields before typing.** Popovers\u002Finputs seeded with the current value need emptying first: `Backspace@25ms 40`. Backspace on an empty field is a no-op, so over-counting is safe.\n- **Don't end the demo with a quit key.** Quitting makes VHS film the shell teardown (scrollback, the setup command reappearing). Instead end on a `Sleep` holding the frame you want — VHS kills the process at tape end, giving a clean final frame.\n- **Hide setup commands.** Wrap `cp`, the CLI launch, and any other plumbing in a `Hide … Show` block so only the demo itself is captured.\n\n## Verification\n\nAfter each render, confirm the GIF actually matches the tape. Requires `ffprobe`\u002F`ffmpeg` (run them on the host, or via the image: `docker run --rm -v \"$PWD:\u002Fvhs\" --entrypoint ffprobe \u003Crepo>-vhs …`).\n\n1. **Dimensions** match the tape's `Set Width`\u002F`Set Height`:\n   ```bash\n   ffprobe -v error -select_streams v:0 -show_entries stream=width,height \\\n     -of csv=p=0 \"$gif\"\n   ```\n2. **Duration ≈ sum of the _visible_ `Sleep`s** (plus visible typing time). Count only actions that are actually captured — exclude anything inside a `Hide … Show` block, since VHS records nothing there, so those sleeps\u002Ftyping never reach the GIF. If it's meaningfully shorter than that, frames were dropped → lower `Set Framerate` and re-render:\n   ```bash\n   ffprobe -v error -show_entries format=duration -of csv=p=0 \"$gif\"\n   ```\n3. **File size** is reasonable for a page asset (rough target: under ~2–3 MB; lighter profile if not). `ls -lh \"$gif\"`.\n4. **(Optional) Eyeball frames** — sample one frame per second to PNGs and look at them:\n   ```bash\n   ffmpeg -i \"$gif\" -vf fps=1 \u002Ftmp\u002Fdemo-frames\u002Ff%03d.png\n   ```\n   Check the first frame (no leftover setup), the final frame (the intended end state), and any edit step.\n\n## Embedding in README or docs\n\nReference the GIF with a plain image tag near the top of the README (after the hero\u002Fbadges):\n\n```markdown\n![\u003Crepo> demo](.github\u002Fassets\u002Fdemo.gif)\n```\n\nA docs page at `docs\u002F2.guides\u002F1.quickstart.md` references its selected artifact relative to the authored page:\n\n```markdown\n![Quickstart terminal demo](..\u002F_assets\u002Fquickstart.gif)\n```\n\nA localized page at `docs\u002Fde-DE\u002F2.guides\u002F1.quickstart.md` references shared media as `..\u002F..\u002F_assets\u002Fquickstart.gif`, or its explicitly captured variant as `..\u002F..\u002F_assets\u002Fde-DE\u002Fquickstart.gif`. Translate its alt text\u002Fcaption. To reuse the README artifact from the default docs page, reference `..\u002F..\u002F.github\u002Fassets\u002Fdemo.gif`; verify that the selected renderer can publish that location before reporting the rendered-page reference complete. Duxt's automatic docs media bridge publishes `docs\u002F_assets\u002F` image outputs; a shared artifact intended for that bridge should live there, with the README referencing `docs\u002F_assets\u002Fquickstart.gif`.\n\nFor multiple demos, embed each under the relevant section with its descriptive name. `write-readme` or `write-docs` owns layout — this skill owns the source, artifact, verification and correct reference. Verify the page-relative path exists and the rendered image resolves where a site is involved; absolute page-link rules do not apply to image paths.\n\n## Steady-state loop (after the first run)\n\nQuick start covers the first run; afterwards only the cadence differs:\n\n- **Image** — rebuild after Dockerfile changes and before recording a new demo with `--pull --no-cache`, so the apt layers actually refresh Debian security packages. `--pull` alone does not invalidate cached layers on a digest-pinned base. Keep the Node\u002FGo base digests, source commits, dependency pins, release versions and checksums together when updating; scan the built image with `trivy image \u003Crepo>-vhs` or the repo's existing container scanner. A scanner finding is reported separately from a successful render.\n- **Every demo change** — run the repo's build (e.g. `pnpm build` \u002F `bun run build`) → re-render → [verify](#verification).\n- **Commit** the tape, Dockerfile, and regenerated GIF together — the tape is the source of truth.\n\n## Reference\n\n- **Open it while writing or editing the `.tape`** — when the directive you need is not already in the tape in front of you, when a theme has to be named exactly, or when a first demo needs a worked walkthrough to take its pacing from: [REFERENCE.md](REFERENCE.md).\n- **Copy these on the first run, before the quick start assumes they exist**: [`templates\u002Fvhs.Dockerfile`](templates\u002Fvhs.Dockerfile), [`templates\u002Fdemo.tape`](templates\u002Fdemo.tape).\n","# vhs-demo\n\nGenerate a terminal-demo GIF from a [Charm VHS](https:\u002F\u002Fgithub.com\u002Fcharmbracelet\u002Fvhs) tape, rendered headless in Docker. The tape is committed; the GIF is a build artifact regenerated from it.\n\n> [!IMPORTANT]\n> **The tape is the source of truth.** Always edit the `.tape` and re-render. Never hand-edit, re-time, or recompress the GIF — it cannot be reproduced and the next render will overwrite it.\n\n## Why Docker\n\nVHS normally wants a real TTY (and on macOS, Homebrew + sometimes a screen recorder). The template builds a headless renderer on a digest-pinned Node\u002FDebian base, installs current Chromium\u002Fffmpeg packages and checksum-verified Bun, builds checksum-pinned VHS source with a patched Go toolchain and network dependency, and builds ttyd against current system libraries. It works in WSL\u002Froot environments with no Homebrew, no TTY, no OBS. Docker is the only host dependency; supported targets are `linux\u002Famd64` and `linux\u002Farm64`.\n\n## Destination & naming convention\n\nResolve the intended **README or docs context before scaffolding**. An optional caller such as `write-docs` passes the target page, context, repo-relative output path, subject\u002Fref and any required language variant; honor that target. Without a target, keep the README default.\n\n- **README demo** → paired tape + GIF under `.github\u002Fassets\u002F`.\n- **Docs demo** → paired tape + GIF under `docs\u002F_assets\u002F`. This is a non-section directory: no numeric prefix, `index.md` or navigation entry.\n- **One demo at the selected destination** → `demo.tape` \u002F `demo.gif`; **multiple demos** → descriptive paired base names, e.g. `quickstart.tape` \u002F `quickstart.gif` or `ci.tape` \u002F `ci.gif`. Honor an explicit output name even for the first demo.\n- **Shared media** → reuse an existing artifact when README and docs show the same demo; do not create a second copy solely to embed it elsewhere.\n- **Language-dependent demos** → explicitly capture and verify variants when needed, e.g. `docs\u002F_assets\u002Fde-DE\u002Fquickstart.tape` \u002F `quickstart.gif`. Shared language-neutral media is referenced across locale pages. Translate alt text and captions; a translation sweep never produces captures.\n- **The Dockerfile stays generic**: `.github\u002Fassets\u002Fvhs.Dockerfile`, shared by both destinations — never named after a demo.\n\nConsumer-specific tapes and regenerated GIFs belong in the consumer repo, never in the published skill. The paired tape is committed, but only the GIF is published as docs media; tapes, scripts and Dockerfiles are not image outputs.\n\n## Quick start\n\n1. **Resolve the target** and set repo-relative paths once. README default:\n   ```bash\n   tape=.github\u002Fassets\u002Fdemo.tape\n   gif=.github\u002Fassets\u002Fdemo.gif\n   ```\n   Docs example:\n   ```bash\n   tape=docs\u002F_assets\u002Fquickstart.tape\n   gif=docs\u002F_assets\u002Fquickstart.gif\n   ```\n   These variables stay set for render and verification commands below; do not use the default README path after selecting a docs target.\n2. **Scaffold** `.github\u002Fassets\u002Fvhs.Dockerfile` from [`templates\u002Fvhs.Dockerfile`](templates\u002Fvhs.Dockerfile). Reuse it when already present; keep or drop the Bun layer (see below).\n3. **Scaffold** the selected tape from [`templates\u002Fdemo.tape`](templates\u002Fdemo.tape), set its `Output` to the exact selected `gif` path, and write the choreography for this CLI. The template's `Output` is the README default and must be replaced for docs, named or localized targets.\n4. **Build the CLI** so the tape runs the built artifact, not the sources: run the repo's build (e.g. `pnpm build` \u002F `bun run build`).\n5. **Build the image** (once, or after editing the Dockerfile):\n   ```bash\n   docker build --pull --no-cache -f .github\u002Fassets\u002Fvhs.Dockerfile -t \u003Crepo>-vhs .\n   ```\n6. **Render** (after every tape change), from the consumer repo root:\n   ```bash\n   docker run --rm --cap-drop=ALL --security-opt no-new-privileges:true \\\n     -v \"$PWD:\u002Fvhs\" \u003Crepo>-vhs \"$tape\"\n   ```\n7. **Verify** the selected GIF (dimensions, duration ≈ sum of sleeps, file size, captured content) — see [Verification](#verification). A committed tape establishes reproducibility, not freshness; render against the intended CLI\u002Fref and check the result.\n8. **Wire the target page's image reference** and commit the tape, shared Dockerfile and regenerated GIF together. Report the source path, verified output path, subject\u002Fref and reference to the caller. The writing skill owns page inclusion and layout.\n\n## Does the CLI need Bun?\n\nThe template includes a **version-pinned Bun layer** for CLIs using `opentui`, `bun:ffi`, or `bun …`. The archive is checked against its pinned SHA-256 before installation; the amd64 build uses Bun's baseline binary. A Bun version change must update both architecture checksums together. No downloaded installer script is executed.\n\n- **Bun CLI** → keep the Bun layer in `templates\u002Fvhs.Dockerfile`.\n- **Node CLI** (plain citty, run with `node …`) → delete the Bun layer; the image already has Node. npm\u002Fnpx are removed from the renderer; install dependencies and build the CLI on the host before rendering.\n\n## Resolution & render quality\n\nDefaults baked into the tape template:\n\n| Setting         | Default (Full HD) | Lighter alternative |\n| :-------------- | :---------------- | :------------------ |\n| `Set Width`     | `1920`            | `1280`              |\n| `Set Height`    | `1080`            | `720`               |\n| `Set FontSize`  | `20`              | `16`                |\n| `Set Padding`   | `16`              | `16`                |\n| `Set Framerate` | `24`              | `24`                |\n\n> [!IMPORTANT]\n> **Cap the framerate.** At 1080p a busy TUI usually can't repaint fast enough to sustain VHS's default **50fps** capture. VHS then drops frames, the GIF plays too fast \u002F janky, and the measured duration is _shorter_ than the sum of your `Sleep`s. `Set Framerate 24` caps the capture rate to something the TUI can actually hold. If verification still shows the duration running short, lower the framerate further (20, then 16) and re-render.\n\nUse the lighter 1280×720 @ FontSize 16 profile when the GIF needs to be smaller\u002Fcheaper to load and Full HD detail isn't essential.\n\n## Pitfalls — do's & don'ts\n\n- **`Output` path MUST be relative** (e.g. `.github\u002Fassets\u002Fdemo.gif` or `docs\u002F_assets\u002Fquickstart.gif`). An absolute path like `\u002Fvhs\u002F...` is rejected by the VHS parser.\n- **Build the CLI first** — run the repo's build (e.g. `pnpm build` \u002F `bun run build`). The tape launches the built artifact (`dist\u002F…`), not the source.\n- **Bun CLIs need the Bun image layer** — see above.\n- **Work on a throwaway copy of fixtures** if the demo edits\u002Fwrites files. Copy them to `\u002Ftmp` inside the hidden `Hide … Show` block so the working tree stays clean (e.g. `cp -r \u002Fvhs\u002Fexamples \u002Ftmp\u002Fdemo`).\n- **Clear pre-filled edit fields before typing.** Popovers\u002Finputs seeded with the current value need emptying first: `Backspace@25ms 40`. Backspace on an empty field is a no-op, so over-counting is safe.\n- **Don't end the demo with a quit key.** Quitting makes VHS film the shell teardown (scrollback, the setup command reappearing). Instead end on a `Sleep` holding the frame you want — VHS kills the process at tape end, giving a clean final frame.\n- **Hide setup commands.** Wrap `cp`, the CLI launch, and any other plumbing in a `Hide … Show` block so only the demo itself is captured.\n\n## Verification\n\nAfter each render, confirm the GIF actually matches the tape. Requires `ffprobe`\u002F`ffmpeg` (run them on the host, or via the image: `docker run --rm -v \"$PWD:\u002Fvhs\" --entrypoint ffprobe \u003Crepo>-vhs …`).\n\n1. **Dimensions** match the tape's `Set Width`\u002F`Set Height`:\n   ```bash\n   ffprobe -v error -select_streams v:0 -show_entries stream=width,height \\\n     -of csv=p=0 \"$gif\"\n   ```\n2. **Duration ≈ sum of the _visible_ `Sleep`s** (plus visible typing time). Count only actions that are actually captured — exclude anything inside a `Hide … Show` block, since VHS records nothing there, so those sleeps\u002Ftyping never reach the GIF. If it's meaningfully shorter than that, frames were dropped → lower `Set Framerate` and re-render:\n   ```bash\n   ffprobe -v error -show_entries format=duration -of csv=p=0 \"$gif\"\n   ```\n3. **File size** is reasonable for a page asset (rough target: under ~2–3 MB; lighter profile if not). `ls -lh \"$gif\"`.\n4. **(Optional) Eyeball frames** — sample one frame per second to PNGs and look at them:\n   ```bash\n   ffmpeg -i \"$gif\" -vf fps=1 \u002Ftmp\u002Fdemo-frames\u002Ff%03d.png\n   ```\n   Check the first frame (no leftover setup), the final frame (the intended end state), and any edit step.\n\n## Embedding in README or docs\n\nReference the GIF with a plain image tag near the top of the README (after the hero\u002Fbadges):\n\n```markdown\n![\u003Crepo> demo](.github\u002Fassets\u002Fdemo.gif)\n```\n\nA docs page at `docs\u002F2.guides\u002F1.quickstart.md` references its selected artifact relative to the authored page:\n\n```markdown\n![Quickstart terminal demo](..\u002F_assets\u002Fquickstart.gif)\n```\n\nA localized page at `docs\u002Fde-DE\u002F2.guides\u002F1.quickstart.md` references shared media as `..\u002F..\u002F_assets\u002Fquickstart.gif`, or its explicitly captured variant as `..\u002F..\u002F_assets\u002Fde-DE\u002Fquickstart.gif`. Translate its alt text\u002Fcaption. To reuse the README artifact from the default docs page, reference `..\u002F..\u002F.github\u002Fassets\u002Fdemo.gif`; verify that the selected renderer can publish that location before reporting the rendered-page reference complete. Duxt's automatic docs media bridge publishes `docs\u002F_assets\u002F` image outputs; a shared artifact intended for that bridge should live there, with the README referencing `docs\u002F_assets\u002Fquickstart.gif`.\n\nFor multiple demos, embed each under the relevant section with its descriptive name. `write-readme` or `write-docs` owns layout — this skill owns the source, artifact, verification and correct reference. Verify the page-relative path exists and the rendered image resolves where a site is involved; absolute page-link rules do not apply to image paths.\n\n## Steady-state loop (after the first run)\n\nQuick start covers the first run; afterwards only the cadence differs:\n\n- **Image** — rebuild after Dockerfile changes and before recording a new demo with `--pull --no-cache`, so the apt layers actually refresh Debian security packages. `--pull` alone does not invalidate cached layers on a digest-pinned base. Keep the Node\u002FGo base digests, source commits, dependency pins, release versions and checksums together when updating; scan the built image with `trivy image \u003Crepo>-vhs` or the repo's existing container scanner. A scanner finding is reported separately from a successful render.\n- **Every demo change** — run the repo's build (e.g. `pnpm build` \u002F `bun run build`) → re-render → [verify](#verification).\n- **Commit** the tape, Dockerfile, and regenerated GIF together — the tape is the source of truth.\n\n## Reference\n\n- **Open it while writing or editing the `.tape`** — when the directive you need is not already in the tape in front of you, when a theme has to be named exactly, or when a first demo needs a worked walkthrough to take its pacing from: [REFERENCE.md](REFERENCE.md).\n- **Copy these on the first run, before the quick start assumes they exist**: [`templates\u002Fvhs.Dockerfile`](templates\u002Fvhs.Dockerfile), [`templates\u002Fdemo.tape`](templates\u002Fdemo.tape).\n",{"name":5,"metadata":24,"description":7,"allowed-tools":26},{"summary":25},"Creates and maintains reproducible README or docs terminal-demo GIFs from VHS tapes.",[27,28,29,30,31,32],"Read","Write","Edit","Bash","Glob","Grep","main","0343b3844cdfe00ebabe556f2a63c0515208e92c","skills\u002Fdocs\u002Fvhs-demo",0,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills","https:\u002F\u002Fgithub.com\u002FTitusKirch","https:\u002F\u002Fkirch.dev\u002F","💼 Self-employed Web Developer\r\n🎓 B. Sc. Computer Science","2026-11-02 00:46:17",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add TitusKirch\u002Fskills --skill vhs-demo",{"tool":48,"command":49},"bunx","bunx skills add TitusKirch\u002Fskills --skill vhs-demo",{"tool":51,"command":52},"pnpm","pnpm dlx skills add TitusKirch\u002Fskills --skill vhs-demo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fvhs-demo\u002FSKILL.md",true,[56,62,68],{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"REFERENCE.md","REFERENCE","参考文档",5817,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fvhs-demo\u002FREFERENCE.md",{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"templates\u002Fdemo.tape","OTHER","其他",2047,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fvhs-demo\u002Ftemplates\u002Fdemo.tape",{"path":69,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":70,"sourceHtmlUrl":71},"templates\u002Fvhs.Dockerfile",4399,"https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fdocs\u002Fvhs-demo\u002Ftemplates\u002Fvhs.Dockerfile",[73,80,87,94,101,108],{"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},"01M74FV6SYWA6MEBCX3EY64484","gamma","The third fixture skill — carries the worklock, plan and tldr blocks, and names the resolver without hosting the config block.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Fwork\u002Fgamma\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M74FV4K7PNY8GTJH2M8ZTJGT","beta","The second fixture skill — carries the tagged blocks but no config block.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Frepo\u002Fbeta\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M74FV2JYBQ3VRP180AZEVQFC","alpha","The first fixture skill — carries the config block and the resolver.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Ftest\u002Ffixtures\u002Fregistry\u002Fskills\u002Frepo\u002Falpha\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M74FTVVHVDTMTP0EX4W924NK","work-review","Reviews a single tracked issue's pushed implementation across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files as a fresh, independent agent — reads the issue's requirements and the pushed diff, adversarially checks whether the work is correct and complete, and writes a verdict that routes the issue to done (accepted), changes-requested (feedback, back to the implement loop), needs-human (escalation), or blocked. It never implements or fixes anything — review only. It also applies a human's verdict on a needs-human issue. Tracker, labels and the round cap come from the committed config (.tituskirch-skills.json). Use when the user wants to review, check, or sign off one specific issue's AI work, mentions an issue awaiting review, or says things like \"review issue 42\", \"check the work on issue 42\", \"reviewe Issue 42\", or gives a verdict on an escalated issue.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-review\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M74FTNQ1RCJTZ929GNJ2FBX5","work-review-queue","Drains a repo's queue of issues awaiting AI review across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files — selects every issue in review, then reviews each with a fresh, independent agent by delegating to work-review, routing each to done, changes-requested (back to the implement loop), needs-human, or blocked. Starts by reconciling issues whose PR a human merged or closed out-of-band. Honours a per-run cap, single-flight-locked with a lock separate from the implement loop's, so review and implement drains run concurrently. Use when the user wants to review, drain, or auto-review the pushed AI work, run the review loop, says things like \"review the queue\", \"reviewe die Issues\", \"drain the review queue\", or starts a repeating driver.","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-review-queue\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M74FTFKF2GBCKMKKHN5QJW0G","work-implement","Implements a single tracked issue across GitHub (gh), GitLab (glab), Linear (MCP) or local issue files — claims it via the lifecycle label, implements on a branch (fresh from ready, or re-work from changes-requested after review feedback), runs the repo's checks, commits and PUSHES, and hands the issue to the review loop by advancing the label to review. It never reviews its own work — the separate work-review skill does that. Tracker, label lifecycle and branch strategy come from the committed config (.tituskirch-skills.json). Use when the user wants to work, implement, action or pick up one specific issue or ticket, mentions an ai-ready issue, or says things like \"work issue 42\", \"arbeite Issue 42 ab\", \"implementiere Ticket X\", or \"address the review feedback on issue Y\".","https:\u002F\u002Fgithub.com\u002FTitusKirch\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwork\u002Fwork-implement\u002FSKILL.md",[],[]]