// the find
zarazhangrui/codebase-to-course
A Claude Code skill that turns any codebase into a beautiful, interactive single-page HTML course for non-technical vibe coders.
A Claude Code skill (prompt + templates, not an app) that asks the model to turn a codebase into a single self-contained HTML 'course' with animations, quizzes, and code-to-plain-English panels. Aimed at non-technical 'vibe coders' who want to understand code they built or found without taking a CS course.
The single-HTML-file output with zero dependencies is a genuinely good constraint — it's shareable, works offline, and can't rot from a broken npm install. The reference docs (design-system.md, interactive-elements.md, content-philosophy.md, gotchas.md) show real iteration on failure modes rather than a one-shot prompt. Scoping quizzes to application ('which files would you touch') instead of recall is a sharper pedagogical choice than most AI-generated tutorials bother with.
There's no actual code here — it's instructions for an LLM, so output quality and consistency depend entirely on which model version runs it and how well it follows a long prompt; there's nothing to unit test. No example generated course is checked into the repo, so you can't see what you're getting before investing codebase + tokens. For anything beyond a toy project, cramming an entire course — diagrams, quizzes, code blocks — into one HTML file risks a huge, slow-loading page, and the README never addresses how it handles large codebases or scales the output down. It's also hard-wired to Claude Code specifically; there's no standalone CLI, so you're stuck with whatever that tool's skill-loading mechanics support.