Communitygithub.com

Erklärvideo-Gestalter

Bearbeitet einen Talking-Head-Clip zu einem Erklärvideo. Der Sprecher sitzt in einem abgerundeten Panel auf einem hellen Hintergrund, der Kopf ragt über die Oberkante hinaus, und der Rest des Bildes erklärt den Punkt mit visuellen Elementen.

Was ist Erklärvideo-Gestalter?

Dieses Skill `explainer` wandelt einen einfachen Talking-Head-Clip in ein professionell wirkendes Erklärvideo um. Der Sprecher wird in ein abgerundetes Panel auf einem hellen Hintergrund eingebettet, wobei sein Kopf leicht über die obere Kante des Panels hinausragt. Der restliche Bildschirm wird genutzt, um den Kernpunkt visuell zu untermauern – entweder durch einen Vorher-Nachher-Vergleich mit Pfeil oder durch eine nummerierte Liste. Es unterstützt zwei Layouts: 'vertical' (Sprecher unten, Grafik oben) für Kurzformate wie Reels oder Shorts, und 'horizontal' (Sprecher seitlich, Grafik daneben) für YouTube oder andere Langformate. Der Workflow umfasst das Transkribieren per Groq, das Festlegen eines 3-8 Sekunden langen Clips, das automatische Herauslösen des Sprechers und das Rendern mit HyperFrames. Entwickler müssen lediglich eine JSON-Spezifikation mit Parametern wie Titel, Augenhöhe, visuellem Typ (Vergleich oder Liste) und Bildpfaden bereitstellen. Das Tool prüft die Ausgabe automatisch auf Überlappungen mit UI-Elementen der Plattform und erlaubt eine einfache Nachbearbeitung. Es eignet sich ideal für Content Creator, die ansprechende Erklärinhalte mit minimalem Aufwand produzieren möchten.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alisolanki/alis-claude-editing-skills/tree/HEAD/skills/explainer

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/explainer

┌──────────────────────┐
│   Steal what works   │  title, one word in the accent
│ [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:

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.

Format

Every spec takes "format": "vertical" (1080x1920: reels, shorts, vertical long-form), "horizontal" (1920x1080: YouTube and other long-form) or "auto" (default: follows the source's shape). Run "$PY" "$KIT/reel.py" probe <video> to see what auto picks. The sheet tints red what the platform covers: the Instagram/TikTok UI on vertical, the YouTube player chrome on horizontal. For a full-length video, use this skill as a moment inside /long-form instead of cutting the clip by hand.

Steps

  1. Clip. Use the clip the user gave (any size; it is cropped to 1080x1920 or 1920x1080, see Format). 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 rulers are in canvas pixels; read the y of the eyes. That is eye_y (vertical: about 700 to 800 for a normal framing; horizontal: about 350 to 450). On horizontal also read the x of the face centre: that is face_x.
  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 the platform 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

{
  "video": "my-clip.mp4", "start": 21.4, "end": 25.66, "out": "my-clip.speaker.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 accent colour.
  • 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* sits on an accent pill, \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 put on the accent pill. Pick 2 to 4 that carry the meaning. Every time the word is said, it is highlighted.
  • Horizontal only: face_x (centres the face in the panel), side ("right" default, or "left"), scale (0.9: how large the speaker is drawn).
  • caption_top: the y of the top of the captions: 1420 vertical (keep its bottom above 1500), 850 horizontal (it sits on the panel; keep its bottom above 960).

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.
  • Vertical: keep the top visuals between y 330 and 760 (the title sits above them, at about 210). Horizontal: the title sits at y 110, the visuals between y 270 and 830 beside the panel. Text and graphics stay out of the red zones; 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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills