Communitygithub.com

Video-Training (Storyboard-zuerst)

Erstellt ein erzähltes Schulungs- oder Walkthrough-Video (inkl. annotierter Folien und PDF), das die echte TenthGear-App zeigt. Beginnt mit einem Storyboard auf einem Design-Canvas, das Dave bearbeitet, erfasst dann Screenshots und Footage aus der Live-App, vertont mit OpenAI Text-to-Speech und setzt das Video zusammen.

Was ist Video-Training (Storyboard-zuerst)?

Dieses Skill produziert Schulungsvideos für die TenthGear-App nach einem strikten Storyboard-zuerst-Workflow. Es stellt sicher, dass alle Inhalte – Keyframes, Callouts, Voice-Over – zuerst von Dave in einem interaktiven Design-Canvas abgesegnet werden, bevor Aufnahmen, Vertonung und Endproduktion starten. Der gesamte Build-Prozess basiert auf einer einzigen `storyboard.json`, die das Projekt treibt. Das Skill unterstützt die Erstellung von Videos, Folien und PDFs aus derselben Quelle, erkennt die echte App im jeweiligen Store-Modus und nutzt OpenAI TTS (Modell `gpt-audio-1.5`) für natürliche Sprachausgabe. Es ist für Claude Code, Cursor und Codex konzipiert und enthält detaillierte Skripte und klare Erfolgskriterien: Jeder gerenderte Frame und Clip stammt aus der Live-App, Daves Canvas-Bearbeitungen werden geerntet, und nach Abschluss wird der Store-Modus ordnungsgemäß zurückgesetzt. Das Skill beinhaltet außerdem Styleregeln von Dave (z.B. Buttons als Chips, kurze Part-Header) und einen Prüfschritt, der offenlegt, was nicht manuell gegengehört/-gesehen wurde.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsonders/claude-skills/tree/HEAD/video-training

In Ihrer bevorzugten KI fragen

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

Dokumentation

Video-Training: Storyboard zuerst, dann die echte App auf dem Bildschirm

Ein Schulungsvideo besteht hier aus einer Reihe von telefonschirmförmigen Karten. Jede Karte hat eine Überschrift, eine einzeilige Hilfe, einen Keyframe aus der echten App mit Callouts und eine Erzählzeile. Manche Karten spielen statt eines Standbilds einen kurzen Clip der App ab. Dieselben Karten werden auch als Folien und PDF ausgeliefert.

Eine Datei steuert alles: storyboard.json. Dave bearbeitet sie über einen Design-Canvas; jedes Build-Skript liest sie.

Wann verwenden

Verwenden für:

  • Ein Schulungs-, Erste-Schritte-, Schnellstart- oder How-to-Video, das die App zeigt
  • Annotierte Screenshots oder ein Folienguide für Techniker, Berater oder Teilemitarbeiter
  • Eine Überarbeitung eines mit diesem Skill erstellten Videos (neuer Wortlaut, neue Karte, neuer Clip)

Nicht verwenden für:

  • Marketing- oder Werbevideos (anderer Ton, andere Regeln; Dave fragen)
  • Kundeninspektionsvideos, die innerhalb des Produkts aufgenommen wurden
  • Einen Mockup eines Bildschirms, den es noch nicht gibt (/visual verwenden)

Prinzipien

  1. Storyboard vor der Produktion. Nichts wird vertont oder zusammengesetzt, bis Dave den Storyboard-Canvas bearbeitet und gesagt hat, dass er fertig ist.
  2. Zeige die echte App, die das Echte tut. Echter Scan, echte Diktierfunktion, echte generierte Story. Niemals ein gemockter Bildschirm, niemals getippte Ergebnisse.
  3. Dave entscheidet auf dem Canvas, nicht im Chat. Lies den Canvas zurück und diff ihn. Baue seine Anweisungen nicht aus der Konversation nach.
  4. Ein genehmigter Take wird behalten. Die Erzählung wird nur für Zeilen neu generiert, deren Wörter sich geändert haben. Überschreibe niemals eine Version, die Dave überprüft hat; versende -v2, -v3.
  5. Claude kann nicht hören oder zusehen. Sage das bei jeder Rückgabe. Belege die Wörter durch Transkription und die Bilder durch Beispiel-Frames, und nenne, was nicht überprüft wurde.
  6. Hinterlasse den Store wie vorgefunden. Modus wiederhergestellt und bestätigt, Wiederholungs-Aufträge geschlossen.

Zuerst lesen

  • /Users/davidsonders/ro-bot/shared/product-facts.md und shared/brand.md: Namen, Zahlen, verbotene Wörter. Keine Gedankenstriche, keine Emojis, „TenthGear“ als ein Wort. Niemals „Einzelspieler“ oder „Mehrspieler“ in etwas, das ein Zuschauer sieht oder hört.
  • reference.md in diesem Ordner: die technischen Fallstricke, jeder bereits einmal bezahlt.
  • Memory-Notizen zum Design-Canvas: reference_design_canvas_mechanics, reference_design_canvas_roundtrip, reference_design_canvas_entity_crash.

Wo die Dinge liegen

WasWo
Projektordner eines Videos/Users/davidsonders/ro-bot/training-videos/<slug>/ (niemals das Session-Scratchpad, das mit der Session stirbt)
Die eine Quelle der Wahrheit<project>/storyboard.json
Keyframes, Clips, Erzählung<project>/frames/, footage/, narration/
Builds<project>/out/
Was Dave erhält~/Desktop/<Title>/
Ausgearbeitetes Beispieltraining-videos/story-writer-getting-started/ und examples/story-writer/ hier

Skripte liegen in scripts/ hier. Sie nehmen den Projektordner als erstes Argument.

Arbeitsablauf

Erstelle eine Todo-Liste für diese Schritte und arbeite sie der Reihe nach ab.

Schritt 0: Briefing klären

Finde diese Angaben in der Anfrage. Frage nur nach dem, was fehlt, eine Frage, Empfehlung zuerst.

EntscheidenStandard
Wer sieht zu und in welcher RolleTechniker
Telefon oder DesktopTelefon, 390 x 844
Welcher Ablauf, Anfang bis EndeDaves Gliederung
Store und Workflow-ModusDave fragen. Siehe Schritt 2.
Nur Standbilder oder Standbilder plus ClipsClips, wo immer sich der Bildschirm bewegt: Aufnahme, Laden, Öffnen und Schließen
LängeUnter 2:30

Schritt 1: Storyboard auf einem Design-Canvas

Das ist das Erste, was Dave sieht, und der Ort, an dem er das Skript und die Callouts bearbeitet.

  1. Erstelle den Projektordner und rendere alle Props (props/render-paper.mjs erstellt den Muster-Papier-Reparaturauftrag).

  2. Erkunde den Ablauf nach Keyframes. Keyframes kommen aus der echten App, daher braucht dieser Schritt einen Capture-Durchlauf (Schritt 2 und Schritt 3, nur Standbilder). Kopiere examples/story-writer/capture-stills.mjs in das Projekt und schreibe den Ablauf um. Sieh dir jeden Frame an, bevor du fortfährst.

  3. Entwirf storyboard.json. Eine Karte pro Sache, die der Betrachter tut. Form:

    { "id": "write-story", "part": 2, "img": "10-write-story",
      "title": "Tippe auf [[Story schreiben]]",
      "body": "Der KI-Schreiber wird deine Notizen prüfen und die 3Cs für dich schreiben.",
      "boxes": [[183, 400, 191, 44]], "arrow": [162, 768],
      "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "Was der Clip zeigt" },
      "narration": "Wenn du bereit bist, tippe auf Story schreiben." }
    

    boxes und arrow sind in Telefon-Pixeln; der Capture schreibt die Box jedes Steuerelements neben seinen Frame. [[Label]] zeichnet einen Button-Chip. Befolge die Stilregeln unten ab dem ersten Entwurf.

  4. Erstelle den Canvas. Artifact-Tool: quickstart mit Absicht design, dann veröffentliche mit der type_url, die es zurückgibt, und einem Titel. Speichere die URL in <project>/storyboard/artifact.json.

  5. Lade die Keyframes als Assets auf den Canvas hoch (JPEG, 1688 px hoch, im Scratchpad bereitgestellt, damit sie in einem Aufruf gehen). Notiere jede zurückgegebene /_blob/... URL unter assets in artifact.json, mit dem Frame-Namen als Schlüssel.

  6. Generieren und veröffentlichen. node scripts/storyboard-canvas.mjs <project> schreibt storyboard/project/. Kopiere diesen Ordner in das Scratchpad und veröffentliche ihn: canvas.json als file_path, jede .dc.html in files.

  7. Gib Dave den Link und halte an. Sage ihm: Tippe alle Wörter auf einer Karte neu, die blaue Notiz unter jeder Karte ist die Sprachspur, ziehe die gelben Callouts, schreibe alles andere auf eine Notiz. Starte nicht mit der Produktion.

  8. Ernte seine Bearbeitungen. Artifact read mit paths (das Index und jedes Artboard) und einem out_dir, dann node scripts/storyboard-harvest.mjs <project> <out_dir>. Lies ihm den Bericht in einfachen Worten vor, handle alle Notizen ab, die er hinzugefügt hat, und führe dann mit --write erneut aus.

  9. Noch eine Runde? Lies project/canvas.json zurück, generiere mit --live <jene Datei> neu, veröffentliche erneut. Eine Veröffentlichung, die nicht vom Live-Index ausgeht, wird abgelehnt.

Schritt 2: Einen Store ausleihen

Die App muss in dem Modus sein, den das Video zeigt. Es dürfen nur Test-Stores verwendet werden.

StoreIdNormalmodusHinweise
Summit Auto Group (Demo)demo-dealershipTeam-WorkflowDaves Interessenten-Demo. Logins [email protected] (Techniker), marcus@ (Berater), priya@ (Teile). Für das erste Video verwendet.
Test Dealership 1mlTaPo12wbpUtJB9GXJMTeam-WorkflowMit Build-Sessions geteilt. Oft ausgelastet.
  1. ListAgents, dann SendMessage an jeden Peer: Nutzt es den Store und braucht es den Modus? Warte auf die Antwort. Wenn ein Peer ihn braucht, verwende den anderen Store oder frage Dave.
  2. Lies zuerst den Modus aus: NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id> aus dem App-Ordner.
  3. Ändere ihn nur für die Minuten, die ein Capture läuft, in derselben Befehlskette wie der Capture und die Wiederherstellung. Lies ihn dann erneut aus und bestätige.
  4. Berühre niemals einen Kunden-Store. Ändere niemals die Einstellungen eines Testkontos.

Schritt 3: Capture

  • Standbilder: dpr: 3. Ein Frame pro Karte, aufgenommen nachdem sich der Bildschirm beruhigt hat.
  • Clips: dpr: 2 mit vt.recorder. Öffne jeden Clip mit einem Schlag der Ruhe, zeige den Fingermarker, dann handle. Lies marks.json, um footage.runs auszuwählen.
  • Diktat ist echt. vt.dictation spielt einen gesprochenen Clip in ein Fake-Mikrofon; die App zeichnet auf und transkribiert ihn. Drucke jedes Transkript und lies es: Der Transkribierer schreibt Zahlen und Markennamen um.
  • Ein Wiederholungsdurchlauf braucht einen frischen Reparaturauftrag. Nummeriere sie aufwärts und liste jede ID in created-ros.txt.

Schritt 4: Folien

node scripts/build-slides.mjs <project> schreibt out/slides/*.png, das PDF und die Ebenen, die das Video braucht. Sieh dir ein Kontaktblatt jeder Karte an. Prüfe, dass kein Callout das bedeckt, worauf es zeigt.

Schritt 5: Erzählung

cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>

Stimme ash, Modell gpt-audio-1.5 (verschoben von gpt-4o-mini-tts, das OpenAI am 06.01.2027 abschaltet). Ein Take, dessen Transkript nicht mit den Karten-Wörtern übereinstimmt, wird wiederholt, dann verweigert. Dave hat diese Stimme genehmigt und die eingebauten Mac-Stimmen als robotisch abgelehnt. Es verwendet den OpenAI-Schlüssel der App und kostet ein paar Cent pro Build: Sage das im Briefing für jedes neue Video, damit die Ausgaben nie überraschen. DRY=1 listet, was neu generiert würde.

Schreibe die Erzählung für das Ohr: „R O“, „drei Cs“, „tenthgear punkt A I“. Kündige jeden Teil auf seiner ersten Karte an.

Schritt 6: Video

node scripts/build-video.mjs <project>. Geschwindigkeit ist 1.25 (QuickTimes „Schnell“), das Tempo, das Dave genehmigt hat. Eine Karte mit einem Clip läuft so lange wie die längere ihrer Erzählung und ihres Clips.

Schritt 7: Verifizieren und sagen, was nicht verifiziert wurde

  1. check-audio.mjs transkribiert das Video und bewertet jede Karte. Lies jede LOOK-Zeile.
  2. Ziehe einen Frame aus jeder Karte, die einen Clip oder einen Pfeil hat, und sieh ihn dir an.
  3. Gib bei der Rückgabe klar an: nicht angehört, nicht bis zum Ende angesehen.

Schritt 8: Ausliefern

Kopiere das Video, das PDF und out/slides/ nach ~/Desktop/<Title>/. Behalte frühere Versionen. Gib die Länge an, was geändert wurde und was Dave auffallen könnte (eine andere Reparaturauftragsnummer in einem Clip, ein Callout, das über Footage gefallen ist).

Schritt 9: Aufräumen

  • Store-Modus wiederhergestellt, dann zurückgelesen und bestätigt.
  • node scripts/close-ros.mjs <project> <email> <org-id> schließt die Wiederholungen. Das Löschen von Reparaturaufträgen ist Daves Entscheidung.
  • Teile jedem Peer, dem du eine Nachricht geschickt hast, mit, dass der Store frei ist.

Stilregeln (Dave, 2026-09-29)

RegelBeispiel
Ein Button, den der Betrachter tippt, wird als Button gezeichnetTippe auf [[Neuer RO]]
Teil-Überschriften sind kurz, ohne „von 3“TEIL 2: GARANTIE-STORY
Das Cover hat keine Schrittanzahl
Eine Karte pro Schritt. Karten zusammenführen, die eine Entscheidung zeigen.Überprüfen und speichern sind eine Karte
Eine Karte fallen lassen, deren Punkt selbsterklärend istUrsache und Korrektur lesen
Sage, wer handelt und womit„Eine Sprachnotiz hinzufügen“, nicht „Eine Notiz hinzufügen“
Wenn zwei Dinge auf dem Bildschirm gemeint sein könnten, zeige auf das einePfeil auf den grünen Button
Alles, was sich in der App bewegt, sollte sich im Video bewegenWellenform, Spinner, Karte beim Öffnen
Werkstatt-WörterRO, Zeile, Story, 3Cs, CP

Dave gibt Folienbearbeitungen nach PDF-Seitennummer. Seite 1 ist das Cover, also ist „S. 7“ Schritt 6. Gib jede Bearbeitung mit Schrittnamen an, bevor du sie anwendest.

Erfolgskriterien

  • Dave hat den Storyboard-Canvas bearbeitet und seine Bearbeitungen wurden geerntet, nicht geraten
  • Jeder Frame und Clip ist die echte App, in dem Modus, um den es im Video geht
  • Folien, PDF und Video stammen alle aus derselben storyboard.json
  • Erzählung per Transkription geprüft; unklare Zeilen benannt
  • Die Rückgabe sagt, was nicht angehört oder angesehen wurde
  • Store-Modus wiederhergestellt und bestätigt; Wiederholungs-Aufträge geschlossen
  • Projektordner außerhalb des Scratchpads behalten

Verwandte Skills

  • /visual für Mockups von Bildschirmen, die es noch nicht gibt
  • /app-testing für die Testkonten und den Live-Pass-Harness, den dieses Skill ausleiht
  • /compound danach, wenn ein Capture einen Produktfehler oder eine neue Falle aufgedeckt hat

Verwandte Skills