explainer-kit
/explainer-kit
Explainer Kit - the support layer the talking-explainer skill runs on - machine setup check, the user's brand + voice profile, voiceover transcription to word timings, audio mastering, the corner-logo overlay, sync check, seam diffs and the tools that turn a character image into a talking mascot. Use it through talking-explainer; use it directly only for its setup ("set up my explainer profile", "run the explainer setup check") or one of its tools by name.
- Author
- brewed-ops ↗
- Repository
- talking-explainer ↗
- Licence
- MIT
- Last repository change
- 02.11.2026
Assessment and security
- Files in this package
- 45
- Scripts
- 18
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 02.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 18 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/blocks_to_sprite.py, scripts/build-brand.py, scripts/cut-sheet.py, scripts/lib/brand.mjs, scripts/lib/python.mjs, scripts/master-audio.py, scripts/mouth-fit.py, scripts/mouth-zoom.py, scripts/new-explainer.mjs, scripts/prep-logo.py, scripts/prep-mascot.py, scripts/profile.mjs, scripts/seam-diff-all.mjs, scripts/setup-check.mjs, scripts/speech-profile.py, scripts/sync-check.py, scripts/tran
What it does and when to use it
Explainer Kit - the support layer the talking-explainer skill runs on - machine setup check, the user's brand + voice profile, voiceover transcription to word timings, audio mastering, the corner-logo overlay, sync check, seam diffs and the tools that turn a character image into a talking mascot. Use it through talking-explainer; use it directly only for its setup ("set up my explainer profile", "run the explainer setup check") or one of its tools by name.
Triggers from the description
Original author description
Explainer Kit - the support layer the talking-explainer skill runs on - machine setup check, the user's brand + voice profile, voiceover transcription to word timings, audio mastering, the corner-logo overlay, sync check, seam diffs and the tools that turn a character image into a talking mascot. Use it through talking-explainer; use it directly only for its setup ("set up my explainer profile", "run the explainer setup check") or one of its tools by name.
How it works
- Phase S - Setup (first run only, skip when <home>/profile/brand.json exists)
- Files
- Hard rules
- When things go wrong
SKILL.md preview
---
name: explainer-kit
description: Explainer Kit - the support layer the talking-explainer skill runs on - machine setup check, the user's brand + voice profile, voiceover transcription to word timings, audio mastering, the corner-logo overlay, sync check, seam diffs and the tools that turn a character image into a talking mascot. Use it through talking-explainer; use it directly only for its setup ("set up my explainer profile", "run the explainer setup check") or one of its tools by name.
---
# Explainer Kit
Shared tools for the talking-explainer skill. It is not a film recipe on its own - the film phases live in
talking-explainer's SKILL.md.
Paths used below:
- `<skill>` = this skill's folder. `<engine>` = `<skill>/../spatial-film`.
- `<home>` = `TALKING_EXPLAINER_HOME` or `~/.talking-explainer`. Profile = `<home>/profile/`.
- `<py>` = the `python` command saved in `<home>/config.json` by setup-check (e.g. `py -3.12` on Windows,
`python3` on macOS).
Run every film script from the film project root. Scripts are proven code - run them, never regenerate them.
## Phase S - Setup (first run only, skip when `<home>/profile/brand.json` exists)
1. `node <skill>/scripts/setup-check.mjs` - fix every MISSING line with the install command it prints, rerun
until it exits 0. Tell the user plainly what to install; do not install system tools without asking. Its
YOUR INPUTS block lists what only the user can bring (TODO / ASK / OPTIONAL) - steps 2-5 fill those.
2. Brand interview, one message (include the voiceover question: ElevenLabs voice clone on a paid plan, or
recording themselves with a decent mic in a quiet room - no route = stop and tell them they need one), then
`node <skill>/scripts/profile.mjs init --name "<brand>" ...` (flags: `--wordmark "Part1,Part2" --logo <file>
--logo-has-text --ink #hex --accent #hex --opener "explains" --cta "Follow for more" --presenter "<mascot name>"
--language "<language>" --films-dir <dir>`). A PNG logo goes through
`<py> <skill>/scripts/prep-logo.py <logo> <home>/profile` first. No logo = wordmark only.
3. Voice: fill `<home>/profile/voice.md` (the template explains both ways) - 5-question interview, or
`<py> <skill>/scripts/speech-profile.py` on the transcript of a 5+ minute unscripted recording of them talking.
4. Presenter: the bundled talking demo, or their own talking character (talking-explainer's "Your own talking
character" section).
5. Music (optional): their own licensed bed at `<home>/profile/music/bed.mp3`. Otherwise the HeyGen catalog
(`npx hyperframes auth login` once, then `node <engine>/scripts/music-search.mjs "<mood>"`) or no bed.
`node <skill>/scripts/profile.mjs show` prints the merged profile at any time.
## Files
| Path | What |
|---|---|
| `scripts/setup-check.mjs` | Checks every tool, saves the Python command, prints install commands for what is missing. |
| `scripts/profile.mjs` | `init` / `show` / `path` for the user's brand profile. |
| `scripts/new-explainer.mjs` | Base scaffold (engine skeleton + kit + brand + SFX + audio). talking-explainer's scaffold calls it - do not run it on its own. |
| `scripts/prep-logo.py`, `scripts/build-brand.py` | Logo cleanup; the corner-logo overlay (`m-brand`) timed from film.json. |
| `scripts/prep-mascot.py` | Normalise a character's pose PNGs, write the manifest, fit blinks when faces exist. |
| `scripts/transcribe.py`, `scripts/words.py` | faster-whisper word timings; print every word with its start time (the storyboard's cue sheet). |
| `scripts/master-audio.py` | Voice loudnorm + sidechain-ducked bed + loudness report. |
| `scripts/sync-check.py`, `scripts/seam-diff-all.mjs` | Render audio vs source word timings; seam diffs with the presenter box masked. |
| `scripts/speech-profile.py` | Measure a speaker's style from a long unscripted recording's transcript. |
| `scripts/cut-sheet.py`, `scripts/mouth-fit.py`, `references/mascot-sheet-prompt.md` | A TALKING character from 3 image prompts: cut the sheets into sprites, fit 6 mouth shapes per pose. |
| `references/voice-script.md` | How to write a script in the speaker's voice (loaded in talking-explainer phase 1). |
| `assets/brand/` | Montserrat 700 + OFL (logo font). The user's logo is copied in per film; SFX come from HyperFrames' `media-use` skill. |
| `template/` | Base kit.css, frame.md, snippets, scene-starter, worker brief, presenter track - talking-explainer layers its Apple look on top. |
| `template/profile/` | Sample profile: brand.example.json, logo.svg, voice.example.md. |
## Hard rules
1. **The speaker's voice is untouchable** - only loudness mastering; the visuals move to the words, never the reverse.
2. **Music must be theirs to use** - their own licensed file, the HeyGen catalog, or none. Never pull a track off
YouTube or a random site.
3. **Sync check** = transcribe the RENDERED mp4, then `sync-check.py` against the source timings. That is the proof
the picture lands on the words - never claim it from reasoning.
4. renders/, .media/, .hyperframes/ and audio files stay out of git.
## When things go wrong
| Symptom | Cause | Fix |
|---|---|---|
| A script says "run setup-check first" | no `<home>/config.json` | `node <skill>/scripts/setup-check.mjs` |
| `prep-mascot.py` needed | custom mascot folder without manifest.json | `<py> <skill>/scripts/prep-mascot.py <home>/profile/mascot` |
| Voice clips after a gain lift | plain gain on a hot take | `master-audio.py` (loudnorm), never plain gain |
| `build-presenter.py` dies in ffmpeg on `vo-master.wav` | audio not mastered yet | run `master-audio.py` first |
| seam-check FAILs ~1% on every cut | the presenter moves across seams | `seam-diff-all.mjs`: 0.00% outside the box = pass |
| Render is ~15x slower than expected | no GPU / software path | render-final prints the gpu mode; close other GPU apps or accept the wait |
Files in this package (45)
- SKILL.md 6 KB
- assets/brand/OFL-montserrat.txt 4 KB
- assets/brand/montserrat-700.woff2 18 KB
- references/mascot-sheet-prompt.md 5 KB
- references/storyboard.md 5 KB
- references/voice-script.md 5 KB
- scripts/blocks_to_sprite.py 3 KB
- scripts/build-brand.py 3 KB
- scripts/cut-sheet.py 8 KB
- scripts/master-audio.py 3 KB
- scripts/mouth-fit.py 16 KB
- scripts/mouth-zoom.py 1 KB
- scripts/new-explainer.mjs 8 KB
- scripts/prep-logo.py 2 KB
- scripts/prep-mascot.py 5 KB
- scripts/profile.mjs 4 KB
- scripts/seam-diff-all.mjs 2 KB
- scripts/setup-check.mjs 10 KB
- scripts/speech-profile.py 3 KB
- scripts/sync-check.py 1 KB
- scripts/transcribe.py 2 KB
- scripts/words.py 1 KB
- scripts/lib/brand.mjs 2 KB
- scripts/lib/python.mjs 1 KB
- template/BRIEF.example.md 2 KB
- template/STORYBOARD.example.md 18 KB
- template/film.json 3 KB
- template/frame.md 10 KB
- template/kit.css 17 KB
- template/profile/brand.example.json 1 KB
- template/profile/logo.svg 1 KB
- template/profile/voice.example.md 2 KB
- template/references/scene-starter.html 3 KB
- template/references/snippets.html 9 KB
- template/references/worker-brief.md 6 KB
- template/src/presenter-track.json 1 KB
- template-9x16/BRIEF.example.md 2 KB
- template-9x16/STORYBOARD.example.md 18 KB
- template-9x16/film.json 2 KB
- template-9x16/frame.md 10 KB
- template-9x16/kit.css 17 KB
- template-9x16/references/scene-starter.html 3 KB
- template-9x16/references/snippets.html 9 KB
- template-9x16/references/worker-brief.md 6 KB
- template-9x16/src/presenter-track.json 1 KB
Versions
The database has no other skills named explainer-kit.
Database snapshot: 13.11.2026 · package version 2bb22727c0b8 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 87talking-explainer
Talking Explainer - turn a topic into a narrated 16:9 (1920x1080, 60fps) motion-design explainer where a TALKING cartoon presenter (real lip sync - six mouth shapes driven by the voice, poses on cue words, blinks) explains it in the user's own voice, with short basic-English… - 100brand-kit
Use when asked to build, generate, or reverse-engineer a brand kit, brand foundations, brand voice profile, or content-platform onboarding profile for a company from its website URL — "zrób brand kit", "brand kit for <company>", "what does our site actually say about us", or… - 87audio-explainer
Audio-first long-form explainer pipeline — takes one audio file (or a YouTube/podcast URL → audio) and produces a faceless overlay-driven video in the dev-essay / tech-podcast style (5-30 minutes, 16:9, no talking head). Orchestrates the existing `ralphy` primitives: yt-dlp pull… - 87audio-explainer
Audio-first long-form explainer pipeline — takes one audio file (or a YouTube/podcast URL → audio) and produces a faceless overlay-driven video in the dev-essay / tech-podcast style (5-30 minutes, 16:9, no talking head). Orchestrates the existing `ralphy` primitives: yt-dlp pull… - 100brand-kit-assistant
Advise users on Contentstack Brand Kit concepts, setup, governance, and on-brand AI generation. Route API-specific tasks to the right Brand Kit capability or reference skill, and enforce brand and safety rules before presenting anything as ready. Use when users ask about… - 100faceless-shorts
Make Mascot Explainer reels / YouTube Shorts / TikToks fully in code on the user's computer - the creator as a flat cartoon mascot drawn in code from one photo (rigged, lip-synced to the voice) presenting numbered how-to steps on cards, with number tiles that slam into a corner…