Skip to content
Skills Library
Marketing & content · Conversion & formats

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.

Licence
MIT
Last repository change
02.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
45
Scripts
18
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 02.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

set up my explainer profilerun the explainer setup check
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

  1. Phase S - Setup (first run only, skip when <home>/profile/brand.json exists)
  2. Files
  3. Hard rules
  4. When things go wrong
Original SKILL.md headings · 73 lines, 790 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.