akshayDev17/ai-explainer-video

Turn a directory of structured coursework notes into a narrated, animated
explainer-video series.
A skill for AI coding agents — Claude Code, Codex, DeepSeek Harness and
Antigravity. Point it at a folder of course notes: it plans the series, writes
the narration, synthesizes the audio, authors the visuals, then renders and
assembles finished MP4s with YouTube-ready chapters and captions.
Its planner does not merely invent titles — it proves completeness: every
content-bearing section is assigned to a video or classified as navigation
(0 orphaned) before any expensive stage runs.
## The pipeline
Stage 0 (/inputs) collects the two things only you can decide — the source
notes directory, and where the finished videos land — plus, optionally, the playlist
name a series is published under (it is never guessed; a series left blank is asked about at 6b).
| # | stage | what it does | cost |
| 1 | /plan | decompose the notes, prove coverage | free, local |
| 2 | /enrich | retitle and curate (skip / merge) | free, agent |
| 3 | /script | write the narration segments | free, agent |
| 4 | /audio | TTS → a measured timeline | network — spends the Gemini key |
| 5 | /scene | author the visuals (diagram / code / svg) | free, agent |
| 6 | /publish | YouTube chapters + captions | free — no TTS, no Chromium |
| 6b | /thumbnail | a 1280x720 thumbnail.png: one hook over a still from the video's own scenes, plus a -Part X, label for a series | free — one Chromium screenshot |
| 7 | /render | frames → H.264 MP4 | local CPU |
| 8 | /assemble | per-segment parts → the finished cut | local CPU |
Stages 1–2 run once for the whole directory; stages 3–8 run once per video. One
video end to end is a valid stopping point — a pilot, or a single-target run.
## Install
Claude Code
sh
claude plugin marketplace add akshayDev17/ai-explainer-video
claude plugin install explainer-video-from-coursework@akshaydev17
Codex
sh
codex plugin marketplace add akshayDev17/ai-explainer-video
codex plugin add explainer-video-from-coursework@akshaydev17
DeepSeek Harness
sh
dsh plugin --profile web add explainer-video-from-coursework
Antigravity
sh
agy plugin install https://github.com/akshayDev17/ai-explainer-video
All four commands install the same npm package — one package, three manifest surfaces,
one copy of all seventeen skills: the eleven video skills, coursework-author, the companion
skill for writing the coursework these videos come from, and the five code-flow skills:
explainer-video-from-codebase, which makes explainer videos of a codebase's major code flows
(Python, TypeScript / JavaScript, Go, C, C++, or a mix), and its four stage skills. It mines the
repo, ranks candidate flows, optionally traces the test suite in a sandbox, has you approve the
flow list, plans the videos, then runs the same per-video stages with verified code panels and
generated flow diagrams. How each platform reads it, and how
to publish, is in
DISTRIBUTION.md.
## Prerequisites
Node ≥ 22 — render.mjs relies on the built-in global WebSocket.
ffmpeg + ffprobe — H.264 encoding, muxing, and duration measurement.
Headless Chromium — npx playwright install --with-deps --only-shell.