code-viz-core

What problem does it solve?

This Skill provides a safe, repeatable engine for turning multiple source files into a single, self-contained HTML “code walkthrough” without manually editing the HTML shell.

Core Features & Use Cases

• Data-driven walkthrough rendering: author JSON data per file and render a side-by-side mentor rail walkthrough from it.
• Scalable multi-file support: add more files by adding more data/*.json, then rebuild to generate one index.html.
• Guardrails for truthfulness: includes an accuracy policy that distinguishes claims you can mark as certain vs inferred.
• Clear boundaries between explanation and review: focuses on explanation/visualization while delegating deep review to review-oriented skills.
• Use Case: generate an explain-code style interactive walkthrough for several functions in a module by producing one JSON payload per source file and compiling them into a single HTML artifact.

Quick Start

Use the code-viz-core skill to assemble a walkthrough by building the explainer directory agents/explainers/<name> into an interactive index.html, then open the produced index.html in a browser to verify the render.