Video-Tutorial zum Terminal
Pfade:
${CLAUDE_PLUGIN_ROOT}ist das Wurzelverzeichnis dieses Plugins. Falls die Variable nicht gesetzt ist, liegt die Wurzel zwei Ordner über dem "Base directory" dieser Skill (<root>/skills/<skill>). Falls die Skills direkt nach~/.claude/skillskopiert wurden, verwende~/.claude/skillsanstelle von${CLAUDE_PLUGIN_ROOT}/skills.
Das Vorbild ist das Video "Gute Praktiken für Git und GitHub": 14 Szenen, ~3:37. Das vollständige Projekt befindet sich
in ${CLAUDE_PLUGIN_ROOT}/skills/video-dev/exemplos/git/ (drehbuch.json, szenen.py, aussprache.json). Öffne die
szenen.py des Beispiels, bevor du deine eigene schreibst.
Falls die Skill video-dev noch nicht ausgeführt wurde (Fragen, Vorbereitung, Ordner), beginne mit ihr.
Vor dem Schreiben: Die Befehle müssen funktionieren
Wer zusieht, wird die Befehle auf dem Bildschirm eintippen. Liste die Befehle des Tutorials auf und führe sie, wann immer möglich, in einem Testordner wirklich aus, um die Syntax zu bestätigen und die tatsächliche Ausgabe (oder eine kurze Version davon) zu kopieren. Erfinde niemals Flags. Wenn ein Befehl ein Konto, Netzwerk oder etwas Zerstörerisches benötigt (push, deploy, rm), führe ihn nicht aus: Überprüfe stattdessen die offizielle Dokumentation.
Struktur
| # | Block | Inhalt |
|---|---|---|
| 1 | Eröffnung | Thema + Anleitung zum Mitmachen: "1 · Video pausieren → 2 · Im Terminal eintippen → 3 · Weiter" |
| 2…n-1 | Schritte | schritt(n, titel, farbe) + Term mit 1–4 Befehlen + eine Box mit Tipp oder Warnung |
| zwischen Schritten | Tipps | Szene ohne Nummer, mit siegel(0.1, "TIPP", PINK), für gute Praktiken (z.B. Conventional Commits) |
| n | Checkliste | Nummerierte Liste mit allen Schritten + "speichern und im nächsten Projekt verwenden" |
Reihenfolge: Von dem, was man einmal macht (konfigurieren), zu dem, was man immer macht (täglicher Arbeitsablauf), und schließlich zum Fortgeschrittenen (Rebase, Tags). Ein Schritt pro Szene; wenn ein Schritt mehr als 4 Befehle hat, teile ihn in zwei Szenen auf.
Drehbuch
- Beginne jede Rede mit "Schritt N:" und sage was und warum vor dem Befehl.
- Sprich den Befehl so, wie er gelesen wird: "git push, Bindestrich u, origin main"; "git switch Bindestrich c"; "feat Schrägstrich login"; "Punkt gitignore". Auf dem Bildschirm erscheint der echte Befehl.
- Wichtige Warnungen erhalten einen eigenen Satz: "Passwort und API-Schlüssel kommen niemals ins Repository."
- Englische Begriffe: Überprüfe, ob sie in der Aussprachekarte enthalten sind (siehe erzaehlung-stimme). Wenn das Thema
ein eigenes Vokabular hat (docker compose, kubectl...), erstelle ein
aussprache.jsonim Projekt.
Das Terminal (Term)
Term(1.0, 700, [ # t für Eintrittszeit, y für Mitte
(2.4, "$", 'git config --global user.name "Mein Name"'), # (Zeit, Typ, Text)
(5.4, "$", 'git config --global user.email "[email protected]"'),
(6.2, "o", "Ausgabe des Befehls in blau"),
(7.0, "#", "# Kommentar in grau"),
])
- Die Zeit jeder Zeile = der Moment, in dem die Erzählung beginnt, den Befehl zu sagen (
--zeiten N). - Es werden 24 Zeichen/s getippt (
CPSim Motor). Ein Befehl mit 40 Buchstaben dauert ~1,7 s; lass die nächste Zeile danach beginnen. - Maximal ~44 Zeichen pro Zeile (size=32). Länger: Brich mit
\um und setze auf einer Zeile">"fort. - Ausgaben (
"o") kurz und realistisch. Kürze: "Initialized empty Git repository". - Verwende neutrale Beispieldaten: "Mein Name", "[email protected]", "mein-projekt", "du/mein-projekt.git". Niemals echte Benutzerdaten.
Hilfselemente, die sich bewährt haben
| Idee | Wie |
|---|---|
| Warnung ("niemals machen") | Box(t, 540, y, "Text", RED, filled=True) ober- oder unterhalb des Terminals |
| Erinnerung | Box(t, 540, ~1030, "gleiche E-Mail wie GitHub-Konto", ORANGE) |
| Wo klicken auf der Website | Box PURPLE mit dem Pfad: "github.com: New repository\n(leer, ohne README)" |
| Zustandsablauf | 3 Box nebeneinander (x 190/540/890, w=290) + Line mit Pfeil + Text mono darunter (git add, git commit) |
| Branch, der von main abzweigt | Line GREEN horizontal (main) + 3 Line PURPLE als Abzweigung + Beschriftungen |
| Gut vs. Schlecht | Grüne Boxen mit guten Beispielen + Text RED mono mit den schlechten ("anpassungen", "final2") |
| Semantische Versionierung | Großer Text "v1.4.2" + 3 Boxen major/minor/patch mit grauer Erklärung |
| Abschließende Checkliste | vertikale_liste(...) oder Box mit w=860 und unterschiedlichen Farben pro Eintrag |
Rhythmus
- Siegel + Titel in 0,1–0,2 s. Terminal erscheint ~1 s, vor dem ersten Befehl.
- Die Tipp- oder Warnbox erscheint, wenn die Erzählung sie erreicht, normalerweise nach den Befehlen.
- Szenen von 12–18 s. Tutorials vertragen etwas längere Szenen als Konzeptvideos, da die Person tippt.
Checkliste vor dem finalen Rendern
- Jeder Befehl auf dem Bildschirm wurde getestet oder in der Dokumentation überprüft.
- Keine Terminal-Zeile ragt über den Rand hinaus (siehe
--preview). - Die Nummerierung der Schritte in der Erzählung stimmt mit dem Siegel "SCHRITT n" auf dem Bildschirm überein.
- Die abschließende Checkliste enthält alle Schritte in derselben Reihenfolge.
- Keine persönlichen Daten (E-Mail, Benutzername, Token) in den Befehlen.