Index of every page on this site: llms.txt
All skills
charlie947 avatar

/vox-explainer

@229022e
Run it yourself

Make a short Vox-style documentary explainer (30-60 seconds) entirely in code with Claude Code. Torn paper, halftone texture, bold condensed type, motion on twos. Use when someone says "make a Vox-style video", "explainer video about...", "why does X happen", or wants a documentary-style motion graphic for LinkedIn, Instagram or YouTube without After Effects or a video generator.

Use this Skill: https://skilld.dev/gh/charlie947/motion-graphics-skills/vox-explainer

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈99 tokens for metadata: the name and description. ≈1.4k when used: this file.

Description uses 5.0% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈398 characters, or 5.0%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Vox-style explainer, built in code

You make a 30-60 second documentary explainer as one HTML file, then export it to MP4. Every frame is code. No video generator, no stock footage.

Before you start: read brand.md and MOTION.md if they exist. If not, run brand-intake first, or ask for hex codes, a font and a logo file. Never call a result on-brand without them.

Step 1: Ask for four things, then wait

  1. The question. One "why" question a stranger half understands. Example: "Why does every brand logo look the same now?"
  2. The facts. Names, dates and numbers that answer it, each with a source link. If the user has none, research them and show the list with sources before building.
  3. The colours. Three hex codes plus one accent. Default (the palette from my logo film): red #B8312A, cream #F1E6D0, paper #FBF7EE, navy #14213D, yellow accent #F2C230. Label defaults as defaults.
  4. The size. 1920 x 1080 (YouTube), 1080 x 1350 (LinkedIn feed) or 1080 x 1920 (Story or Reel).

Do not start building until every fact on screen has a source.

Review rules (from the rounds that got rejected)

  • Sound is not optional. A silent explainer feels unfinished. Write a score in code: a low bed, a hit on each new shot, a lift on the last line.
  • Cards and images, not lines. A single bar or line moving across the screen reads as static. Every shot uses cards, real images or objects that move in depth.
  • Logos fill their card and come from the real files. A logo floating small in a big box looks wrong.
  • Keep grids symmetrical. Equal card sizes, equal gaps. A lopsided layout reads as a mistake.
  • The voice sits on top. If you can't hear the narration over the effects, drop the score until you can. A voice track (your own, or a text-to-speech one) carries a "why" film.
  • The opening line has to promise what's coming. A small title that undersells the film loses people before the good bit. Say the question big, then show the first surprise within 5 seconds.
  • Every spoken fact gets a source in a facts file before it goes in the script. Say "looks like", never "is", when the research only shows a similarity.
  • Stunning or it's not done. If the first 3 seconds would not stop your own thumb, rebuild them before building the rest.

Step 2: Write the script, one line per shot

  • 8-14 shots. One sentence each. Shot 1 is the question itself.
  • Every shot answers something the line before it said. If you cannot say what a shot proves, cut it.
  • The last shot is the takeaway, in five words or fewer.

Show the script as a numbered list and wait for a yes.

Step 3: Pick a shot type for each line

Shot Use it for
Kinetic statement One sentence you want remembered. Three short lines of bold condensed type on a torn paper strip.
Paper cards Showing several things at once (logos, products, quotes). Torn-edge cards drop in with small shadows.
Before / after A change over time. Same card, date chip flips.
Label call-out Naming one thing inside a picture. A marker circle draws itself, then a label.
Counter A number that grows. Built in code, never guessed.
Grid "They all look the same." Many identical tiles, then one breaks the pattern.

Step 4: Build it

Paste this build brief into Claude Code with the script and shot list underneath:

Build one self-contained HTML file called index.html. No external fonts, images or libraries unless I attached them. Nothing loaded from the internet.

Look: editorial documentary explainer. Palette strictly [RED], [CREAM], [NAVY] with a [YELLOW] accent. Torn paper cards with small drop shadows. Halftone dots, paper grain and fine film grain over the whole frame. Colour fringing at the frame EDGES ONLY, and a soft vignette. Bold condensed sans-serif type, fully formed as blocks.

Motion: STEPPED, animating on twos (hold each drawn pose for 2 frames at 24fps). Never smooth corporate easing. NO typewriter effect. No gradients on text, no glow, no bouncing.

Facts: every name, date and number on screen is typed exactly as given in my fact list. Add nothing I did not give you.

Timing: follow my shot list. Each shot holds long enough to read aloud.

Build rules: work out every frame from the time alone. Add window.seek(seconds) that draws that exact moment. The last frame can differ from the first (this is a film, not a loop).

After the build: capture one frame from the middle of every shot. Check each for cut-off text, overlapping cards, misspelt names and any date that is not in my fact list. Fix what is real and keep the first version.

Step 5: Check it like an editor

Before export, go through every frame capture and confirm:

  • Every date and name matches the fact list, character for character.
  • No card covers another card's text.
  • Nothing is smooth that should be stepped.
  • The first 3 seconds already show the question (people decide in 3 seconds).

Step 6: Export

Easiest route: HyperFrames, free and open source from HeyGen (npx skills add heygen-com/hyperframes, then npx hyperframes render). Any tool that steps through window.seek and saves frames as MP4 also works. Check which tools exist before installing anything, and ask before installing.

What this skill will not do

  • Invent a fact, a date or a quote.
  • Recreate a real brand's logo from memory. Use the user's files or plain type set in the brand's name.
  • Claim a trend is caused by one thing. Say "one reason", not "the reason".

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill is safe. It assists in creating documentary-style HTML explainers and suggests using a well-known third-party utility for video export.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Signed by skilld at 229022e. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub last month.

Steadyupdated 2 months ago

README badge

README badge for charlie947/motion-graphics-skills/vox-explainer