Formate, ein Skill und ein Service versenden (Kursschritt 12)
Drei Schritte verwandeln einen guten Clip in ein wiederholbares Geschäft: Jedes Format von einer Timeline exportieren, die Pipeline als Skill verpacken, damit das nächste Video ein Satz ist, und es – falls gewünscht – verkaufen. Arbeite im Projektverzeichnis. Argumente, einmalig gezeigt:
Die Dateien dieses Skills liegen in ${CLAUDE_SKILL_DIR} (Vorlagen in assets/).
1. Pro Format umrahmen, nie zuschneiden
Szenen zeichnen gegen das Layout L (ctx.L in der Factory, c.L in einer draw-Funktion), sodass eine Timeline 9:16, 1:1, 16:9 (und 4:5) rendert – mit für jede Form platzierter Typografie und UI.
| Format | Größe | Bezeichnung |
|---|---|---|
9x16 | 1080x1920 | Reels, TikTok, Shorts |
1x1 | 1080x1080 | X / Feed |
16x9 | 1920x1080 | YouTube, Website |
4x5 | 1080x1350 | Feed Hochformat |
| Werkzeug | Verwendung |
|---|---|
L.u | Größen-Einheit: 1 bei einer 1080 px kurzen Seite; 120 * L.u liest in jedem Format gleich groß |
L.S | das sichere Rechteck {x, y, w, h} aus studio.json safe[fmt] (UI-Ränder der Plattform) |
L.pos(ax, ay) | ein Punkt innerhalb des sicheren Rechtecks, ax, ay von 0 bis 1 |
L.pick({ '9x16': a, '1x1': b, '16x9': c, portrait, landscape, square, default }) | format-spezifische Werte: exakter Schlüssel, dann Ausrichtung, dann Standard |
L.split('auto', ratio, gap) | zwei Bereiche: gestapelt bei Hochformat und Quadrat, nebeneinander bei Querformat |
L.cols(n, gap) / L.rows(n, gap) | Spalten oder Zeilen innerhalb des sicheren Rechtecks |
fitFontSize(g, text, maxW, (s) => font(s, family, weight), lo, hi, { tracking, step }) | die größte Größe, die in eine Breite passt (lib/layout.js + lib/draw.js); step: 16 für Bitmap-Schriften |
wrapText(g, text, maxW, font(size, family), { maxLines, ellipsis }) | Zeilen für mehrzeiligen Text, niemals innerhalb einer koreanischen Silbe brechen (lib/draw.js) |
draw(g, lt, c) {
const { L, brand } = c;
const { a, b } = L.split('auto', L.pick({ landscape: 0.45, default: 0.4 }), 32 * L.u); // Titel | Produkt
const size = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
fitFontSize(g, 'MACH ES BEWEGEND.', a.w, (s) => font(s, brand.fonts.display, 400)));
kinetic(g, 'MACH ES BEWEGEND.', a.x, a.y + a.h * 0.6, lt, { size, family: brand.fonts.display, weight: 400, color: brand.colors.fg, spring: 'default' });
drawProduct(g, b, lt, c); // das Produkt-UI füllt Bereich b in jedem Format
}
Regeln: keine direkten Pixel; Schlüsselinhalte innerhalb von L.S; derselbe Moment geschieht zeitgleich in jedem Format (nur Platzierung und Größe ändern sich); ein Format, das wie ein Ausschnitt eines anderen aussieht, ist ein P1 in der Kritik. Passe die safe-Ränder in studio.json an, nicht im Code. Vorschau jedes Formats mit npm run preview (F schaltet Formate um, G zeigt die sicheren Hilfslinien).
2. Jedes Format prüfen
Der Kritik-Durchlauf erfolgt im primären Format; vor dem Finale mindestens eine Runde pro anderem Format, jeweils mit eigenem Nachweis (ca. 115 s Tool-Zeit pro Live-Durchlauf und 85 s pro --video-Durchlauf, gemessen an einem 12 bis 20 s Film):
node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5 # ca. 20 s; dann: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9 # Live-Film -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4 # gemischter Render -> out/review/16x9/video/
Protokolliere jede als eigene Runde (## Runde <n> — 16x9 — ...). Das Gate liest die letzte Runde, beende daher mit einer bestandenen Runde.
3. Rendern, mischen, liefern
Diese Schritte dauern Minuten: Der 12-s-Demo-Render dauert etwa 4 min für drei Formate bei 60 fps (ca. 20 s pro Sekunde Film), mix dauert 40 bis 80 s und deliver etwa 40 s. Starte npm run build, render:final, mix und deliver mit der run_in_background-Option des Bash-Tools und einem Log, frage das Log ab (tail -n 3), lies das Ergebnis nach der exit-Zeile und warte nie länger als etwa 2 Minuten im Vordergrund; füge --chunk 10 bei einem Finale mit drei oder mehr Formaten oder bei mehr als ca. 30 s hinzu. Das Motion-Reel-Runbook („Lange Befehle“) enthält das Muster.
| Schritt | Befehl | Ausgabe |
|---|---|---|
| alles, in Reihenfolge | npm run build | Score (falls fehlend), SFX, finaler Render aller Formate, Mix, Deliver |
| finaler Render (gegated) | npm run render:final | out/<fmt>/silent.mp4, poster.png, render.json für jedes Format in studio.json formats |
| Mix und Mux | npm run mix | out/score.wav, out/<fmt>/final.mp4, out/final.mp4 (primär), out/poster.png |
| Prüfungen und Paket | npm run deliver | out/deliver/<slug>_<fmt>.mp4 + Poster + jede Seite des Kontaktbogens (<slug>_<fmt>_contact.png, dann _contact-2.png …), out/deliver/manifest.json, docs/production.json |
deliver.mjs prüft pro Format out/<fmt>/final.mp4 gegen die AKTUELLE studio.json: Framecount (Dauer × fps), die Formatgröße, fps und exakte Dauer (ein vor einer Bearbeitung von duration oder fps gerenderter Schnitt schlägt fehl als stale render; ein Entwurfs- oder skalierter Render schlägt ebenfalls fehl), integrierte Lautstärke und True Peak gegen audio.lufs ± audio.lufsTolerance und audio.truePeak; Stummphasen (eine Phase von 1 s oder mehr unter -50 dB schlägt fehl als silence, z. B. silence 2.2 s at 00:02.1, es sei denn, sie beginnt in den ersten 0,3 s, beginnt in der letzten Sekunde oder liegt innerhalb eines critique.allowSilence-Intervalls); Dateigröße gegen deliver.maxBytes (Standard x: 536.870.912 Bytes = X‘s 512 MB Upload-Limit; füge die Limits anderer Plattformen dort hinzu); Poster vorhanden; die Loop-Naht bei Loop-Filmen; und das Kritik-Gate. Es warnt (kein Fehler), wenn Filmquellen neuer sind als der Render. Es beendet mit 1 und benennt jede fehlgeschlagene Prüfung; ein nicht lesbares final.mp4 schlägt ebenfalls fehl. Mit --json gibt ein Fehler eine Zeile { ok: false, error, failed: [...] } aus, auch wenn der Lauf nicht starten kann (eine ungültige studio.json, ein unbekanntes Format, ein falsches Flag).
--format 1x1 liefert nur dieses Format erneut aus und behält die gelieferten Dateien und Manifest-Einträge der anderen (carriedOver); ein fehlschlagendes Gate widerruft jede gelieferte Datei. docs/production.json zeichnet Titel, Formate, Dauern, Lautstärke, Runden, letzte Scores, den Aufwand (aus CLAUDE_EFFORT falls gesetzt) und Tool-Versionen auf.
| Fehlgeschlagene Prüfung | Behebung |
|---|---|
Frames oder Dauer abweichend, oder stale render | npm run render:final erneut ausführen; niemals einen teilweisen Render ausliefern |
| Lautstärke oder True Peak | /motion-studio:sound-design (Mix-Berichtstabelle) |
silence | Ein Stem endet früh oder ein Bett läuft unter nichts: neu generieren (npm run score, sfx, voice), npm run mix, erneut ausliefern |
| Größe über Limit | node tools/render.mjs --format <f> --final --crf 18 dann npm run mix erneut |
| Poster fehlt | studio.json poster (Sekunden) setzen oder --no-poster weglassen |
| Gate | /motion-studio:critique-loop |
Melde dem Benutzer: jede Datei in out/deliver/, die format-spezifischen Zahlen aus dem Manifest, die Scores der letzten Runde und was du als nächstes verbessern würdest.
4. Die Pipeline als eigenes Skill des Benutzers verpacken
Damit das nächste Video ein Satz ist (/acme-reel launch video for dark mode, 20 s, vertical):
- Wähle den Namen:
<brand>-reel, Kleinbuchstaben, Ziffern und Bindestriche. - Erstelle
.claude/skills/<brand>-reel/SKILL.mdim Repository der Marke (Projektumfang, über Git geteilt) oder in~/.claude/skills/<brand>-reel/SKILL.md(persönlich). Beginne mit${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md(assets/brand-skill-template.md). - Befülle es aus diesem Projekt, nicht aus dem Gedächtnis:
studio.jsonMarkenwerte,docs/style_guide.md, die genehmigtedocs/shotlist.mdals Story-Beat-Muster und die Lektionen indocs/review_log.md(was der Kritiker stets beanstandete, wird zur harten Regel). Kopiere das Logo nach.claude/skills/<brand>-reel/assets/. - Halte die Beschreibung unter etwa 230 Zeichen mit konkreten Auslösephrasen, den Text unter etwa 200 Zeilen.
- Teste es in einer frischen Sitzung mit einer echten Anfrage und überprüfe, dass es nur nach dem fragt, was sich pro Video ändert.
- Um es über ein Repository hinaus zu teilen, veröffentliche es als Plugin (ein Repository mit
.claude-plugin/plugin.jsonundskills/<name>/SKILL.md), so wiebuildwithhanif/claude-animation-skillund dieses Plugin veröffentlicht sind.
5. In einen Service verwandeln (optional)
${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) ist eine ausfüllbare Angebotsvorlage: Was enthalten ist (Musik, ein Maskottchen in jedem Stil, Produktfunktionen, ein Angebot am Ende, jede Sprache, bis zu 3 Bearbeitungen), Formate, Durchlaufzeit, was der Kunde bereitstellt, Rechte und Offenlegung sowie Preisgestaltung. Preisanker: Tony Dinh berichtete, etwa 1.000 $+ für ein ähnliches Launch-Video bezahlt zu haben, ein Jahr bevor er eines mit Opus 5.5 in unter 30 Minuten erstellte (https://x.com/tdinh_me/status/2103703135902740699). Hilf dem Benutzer, es auszufüllen; veröffentliche oder sende es nicht für ihn.
Als Nächstes: Beginne den nächsten Film mit /motion-studio:motion-reel oder dem neuen /<brand>-reel-Skill des Benutzers.