Skip to main content
skill CX Codex

explainer · artemnovitckii — Claude Code skill: what it does, how to install

This Claude Code skill turns a talking-head clip into a vertical explainer with visuals and captions. It starts with /explainer or a request to put the speaker below the visuals in a 9:16 video.

MIT ★ 94 updated 2026-10-30

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skills
Open on GitHub

What explainer does

The skill builds a vertical reel from a supplied video. The speaker sits in a lower panel while the upper area shows a before-and-after comparison or a numbered list. Captions are white, with key words set in a serif style.

A script transcribes the speech and helps select a 3–8 second passage; a frame is used to set the speaker’s eye line. The clip settings go in a JSON file beside the video. The build step cuts out the speaker, renders through HyperFrames, and produces a sheet for review. Visuals come from the user’s own images.

Transcription requires GROQ_API_KEY; ffmpeg and Node are also needed. On first use, set up the Python environment with setup.sh --cutout.

What it helps with

  • turn a talking-head recording into a vertical reel
  • show a before-and-after comparison above the speaker
  • time visual cards to the words being spoken
  • emphasize key words in captions

Example prompts for the agent

  • Edit this clip as an explainer, with me below and visuals above.
  • Turn this video into a vertical explainer with a numbered list and captions.

How to install explainer

1Plugin marketplace

/plugin marketplace add artemnovitckii/claude-editing-skills
/plugin install editing-skills@claude-editing-skills

This installs the whole editing-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add artemnovitckii/claude-editing-skills --skill explainer -a claude-code

3Manually: put the files in place

~/.claude/skills/explainer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/explainer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about explainer

How do I install explainer in Claude Code?

Add the marketplace with /plugin marketplace add artemnovitckii/claude-editing-skills, then install the skill with /plugin install editing-skills@claude-editing-skills.

What does the explainer skill do?

It turns a talking-head video into a vertical reel with the speaker in a lower panel, visuals above, and captions that emphasize key words.

What does explainer need to run?

Transcription needs GROQ_API_KEY, and the skill also needs ffmpeg and Node. Its first run sets up a Python environment through setup.sh --cutout.

Source text

SKILL.md · MIT
---
name: explainer
description: Edits a talking-head clip into an explainer reel. The speaker sits low in a rounded panel on a light backdrop with their head breaking out over its top edge, and the top of the frame explains the point with visuals (a before-to-after comparison with an arrow, or a numbered list). White captions set the key words in a serif. Use when the user runs /explainer or asks for "me at the bottom, visuals on top" on a 9:16 clip.
---

# /explainer

```
┌──────────────────────┐
│   Steal what works   │  title, one word in serif italic
│ [before] ⟶ [after]   │  compare: card, drawn arrow, reveal  (or a numbered list)
│      ╭──head──╮      │  the head breaks out over the panel
│ ╭────┴────────┴────╮ │
│ │  speaker, captions│ │  rounded panel, eye line = its top edge
│ ╰──────────────────╯ │
└──────────────────────┘
```

## First use
This skill's folder is the "Base directory" Claude Code shows when it loads it. Resolve the kit from it (works through symlinks), and set up once:
```bash
SKILL_DIR="<base directory of this skill>"   # the path Claude Code printed as "Base directory for this skill"
KIT=$(python3 -c 'import os,sys;print(os.path.realpath(os.path.join(sys.argv[1],"..","..","kit")))' "$SKILL_DIR")
PY="$KIT/.venv/bin/python"; [ -x "$PY" ] || bash "$KIT/setup.sh" --cutout
```
`GROQ_API_KEY` must be set to transcribe (free at console.groq.com). Needs ffmpeg and Node.

## Steps
1. **Clip.** Use the 9:16 clip the user gave (any size; it is cropped to 1080x1920). Ask for it only if none was given.
2. **Words.** `"$PY" "$KIT/reel.py" words <video>` prints every word with its time (it transcribes on first use). It prints one sentence per line with `[ends …]`, the time its last word ends. Pick one stretch of 3 to 8 seconds that makes ONE point, made of whole sentences: `start` is the first word's time and `end` is the last sentence's `[ends …]` (source seconds).
3. **Eye line.** `"$PY" "$KIT/reel.py" frame <video> <a time in the stretch> frame.jpg`, then look at the image. The red ruler is in 1080x1920 pixels; read the y of the eyes. That is `eye_y` (about 700 to 800 for a normal framing).
4. **Spec.** Write `<clip name>.explainer.json` next to the clip (fields below). Paths in a spec are relative to the spec file. Every time is either seconds from `start` or a spoken word to anchor on (`"viral"`, `"viral#2"` for its second time, `"viral+0.2"`). Prefer words: they stay right when you move `start`.
5. **Build.** `"$PY" "$SKILL_DIR/build.py" <spec.json>`. It cuts the stretch, cuts the speaker out (about 0.1 s per frame), renders with HyperFrames and writes `<out>.sheet.jpg`.
6. **Check.** Look at the sheet. Red is what Instagram covers. Fix the spec and rebuild if:
   - the title or visuals sit in the red
   - a caption covers the mouth, or sits within 80 px of the red bottom zone (move `caption_top`)
   - a caption shows a word from outside the stretch (move `start` or `end` to the sentence edges)
   - the head doesn't break out over the panel (move `eye_y`)
   - an image is missing or squashed
7. **Hand over** the mp4 path and say in one line what each visual shows.

## Spec
```json
{
  "video": "my-clip.mp4", "start": 21.4, "end": 25.66, "out": "my-clip.explainer.mp4",
  "title": "Steal what *works*",
  "eye_y": 750,
  "visual": {
    "type": "compare",
    "left":  {"label": "Another niche", "images": ["theirs-1.jpg", "theirs-2.jpg", "theirs-3.jpg"], "at": 0.3,
              "chip": "14× viral", "chip_at": "viral", "swipe_at": ["carousel", 2.3]},
    "right": {"label": "Your niche", "at": "outside", "reveal_at": "recreate",
              "image": "my-photo.jpg", "text": "the best *ai tools*\nto use when\nyou're *young and broke*"},
    "arrow_at": "and"
  },
  "keys": ["viral", "outside", "recreate"],
  "caption_top": 1420
}
```
- `title`: 1 to 4 words. Wrap ONE word in `*...*` for the serif accent.
- `visual.type: "compare"` is a before and after:
  - The left card shows 1 to 3 images and swipes between them at `swipe_at`.
  - The right card starts as a dashed "?". The arrow draws at `arrow_at`, then the card reveals at `reveal_at`.
  - The right card is either a plain `image`, or a carousel cover made from `image` plus `text` (`*word*` turns yellow, `\n` breaks the line).
- Either card can be a **text card** instead of images: `"big": "*Pro*\ntools", "small": "what pros use"`. Use it when the user has no images. It is the right choice for a left/right comparison the speaker points at.
- `visual.type: "list"`: `{"type": "list", "items": [{"text": "Find a *viral* post", "at": "find"}, ...]}`. Up to 4 numbered rows, each landing as it is said.
- `keys`: caption words to set in the serif. Pick 2 to 4 that carry the meaning. Every time the word is said, it is set in the serif.
- `caption_top`: the y of the top of the captions, 1420 by default. Keep it under the mouth, and its bottom (`caption_top` + 80) above 1500.

## Taste
- One point per clip. If the stretch makes two points, make two explainers.
- Land each visual on the word that names it. Nothing should appear before it is said. The title is the exception: it is there from the first frame.
- Keep the top visuals between y 330 and 760 (the title sits above them, at about 210). Text and graphics stay out of the top 220 px, the bottom 420 px and 100 px at each side. The speaker's panel may run into them.
- If the speaker points left and right, use `compare`. Its cards sit where they point.
- Use the user's own images. Never invent numbers or results about someone else's post. A chip like "14× viral" must be something the user said or gave you.

© Artem Novitckii · MIT · artemnovitckii/claude-editing-skills

Similar skills

All skills for Marketing and content →

explainer by other authors comes first.

explainer marswaveai A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that builds explainer videos combining a voiceover with AI-generated visuals. CX Codex +1 1,100installs explainer Pika-Labs explainer turns any URL into a 60-80 second video: a real browser tours the page while an avatar with lipsync narrates what is on it. CX Codex +1 1,700installs explainer-video iart-ai explainer-video walks the agent through the full pipeline: script, storyboard, scene build, narration and caption sync. Useful when one idea has to become a 30–90s video. CX Codex +1 3,000installs charles-claude-editing LemonFace0309 The charles-claude-editing Claude Code skill edits talking-head footage for Reels and TikTok. It activates on requests to trim clips, add captions, music, or visual overlays. CX Codex +1 ★ 237repo stars reel-editor nicolapocock reel-editor is a Claude Code skill that turns raw talking-head clips into vertical social videos matching brand rules. It triggers on raw video drops, brand setup, or cover requests. CX Codex +1 875installs AutoClip zhouxiaoka AutoClip clips long videos into short-form content with covers and captions — for TikTok, Shorts, Reels and other platforms. CX Codex +1 ★ 12,915repo stars MakeAIVideo makeaivideo-ai MakeAIVideo — an MCP server that builds short-form videos with voiceover and captions from a prompt or script. Posts finished clips to TikTok, Reels and Shorts. CX Codex +1 explainer-video-production calesthio explainer-video-production is a Claude Code skill that turns a topic, brief, or research set into an explainer video plan. It covers claims, storyboards, captions, localization, and QA. CX Codex +1 173installs

From the same set12

The whole set →
shape-shift The shape-shift Claude Code skill builds portrait videos with a match cut between circular subjects. Each subject aligns to one anchor while the speaker stays below the photo panel. CX Codex +1 ★ 94repo stars orbit-reel The orbit-reel Claude Code skill builds portrait videos with image cards moving around a speaker in a 3D ring. Run it to apply this treatment to a portrait clip. CX Codex +1 ★ 94repo stars ranking-list The ranking-list Claude Code skill turns a vertical talking-head clip into a tier-ranking reel. Items appear as they are named, then move into their tier when the speaker gives a verdict. CX Codex +1 ★ 94repo stars trial-reels This Claude Code skill turns one clip into three reels with distinct visual treatments. It runs with /trial-reels or a request for alternate versions of a vertical clip. CX Codex +1 ★ 94repo stars storytelling A skill for Claude Code turns a talking-head clip into a vertical story reel with three cards and captions. It starts with /storytelling or a request for a story, proof, or lead-magnet edit from 9:16 footage. CX Codex +1 ★ 94repo stars split-screen This Claude Code skill turns a talking-head clip into a vertical split-screen reel. It places visuals above the speaker and captions across the dividing line. CX Codex +1 ★ 94repo stars behind-the-person A Claude Code skill edits vertical talking-head clips with graphics layered behind the speaker. Run /behind-the-person or ask for visuals behind a person. CX Codex +1 ★ 94repo stars editing-skills The editing-skills Claude Code plugin builds vertical videos from talking-head clips and photos. Six workflows time graphics to speech, while five more use photographic templates. ★ 94repo stars

Project sponsors

Companies that keep this analytics open