Communitygithub.com

kaskth/cinecode

Erstellt gemeinsam mit dem Benutzer einen Kurzfilm, Animation, Werbung oder Musikvideo vollständig mit Code. Zwei erste Fragen – der Modus (Quick – eine HTML-Datei mit Web-Audio-Sound, wenige Fragen, ein Low-Res-Entwurf, zwei Überarbeitungen, dann das Finale, bis etwa 3 Minuten; Film – sechs gestufte Schritte mit Style-Frame, Animatic, Three.js-Render und geschichtetem Sound) und der Zweck (kinematografischer Film oder Werbung & Produkt). Auch: ein Film zum eigenen Song, ein Film wie ein Referenzvideo mit Änderungen, eigenes Filmmaterial geschnitten. Endet in einem MP4 mit -14 LUFS Master.

Was ist cinecode?

Cinecode ist ein KI-Agenten-Skill, der es Benutzern ermöglicht, gemeinsam mit einer KI einen kompletten Kurzfilm, Animation, Werbespot oder Musikvideo zu erstellen – ausschließlich mit Code. Der Skill unterstützt zwei Hauptmodi: „Quick“ (schnell, bis ca. 3 Minuten) erstellt ein komplettes HTML-Filmchen mit Web-Audio-Sound und wenigen Entscheidungspunkten, während „Film“ einen aufwändigeren, sechsstufigen Produktionsprozess mit Style-Frame, Animatic, Three.js-Rendering und mehrschichtigem Sound bietet. Die Nutzung ist besonders auf Plattformen wie Claude Code, Cursor und Codex ausgelegt und nutzt deren Frage- und Dateianzeige-Tools für eine interaktive Zusammenarbeit. Der Skill beginnt mit der Klärung von Modus und Zweck (kinematografischer Film vs. Werbung), führt dann durch einen strukturierten Workflow aus Recherche, Skripterstellung, visueller Entwicklung, Schnitt und Sounddesign, und endet mit einem professionell gemasterten MP4-Video (-14 LUFS). Dadurch werden technische Hürden gesenkt und ein experimentelles, schnelles Storytelling ermöglicht, bei dem der Benutzer die kreative Kontrolle behält.

Funktioniert mit✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kaskth/films2/tree/HEAD/.agents/skills/cinecode

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht cinecode?

Du erstellst einen Kurzfilm mit dem Benutzer. Sein Geschmack entscheidet; du erledigst den Rest: Geschichte, Drehbuch, Bild, Ton, Schnitt, Prüfungen. Ziel ist ein Film, der das Warten lohnt. Du arbeitest am besten mit einem kurzen, genauen Plan und deinen eigenen Augen: also ist der Plan eine Karte mit Zahlen, du schaust auf Standbilder, bevor etwas Langes rendert, und jede Notiz wird zu einer Zahl, die du änderst.

Diese Datei ist der Kern. Öffne eine Referenz nur, wenn ein Schritt sie nennt, und nur deren Abschnitt. Die Werkzeuge des Kits setzen die mechanischen Regeln durch (Striche in Wörtern, Standbild oder wiederholte Entwürfe, das Show-First-Lock, der Filmordner, Fragesprache, Chat-Größe): wenn eines stoppt, gibt es aus, was zu tun ist; folge ihm, anstatt es zu wiederholen.

Antworte in der Sprache des Benutzers; Projektdateien bleiben auf Englisch, es sei denn, der Benutzer wünscht etwas anderes. Nachrichten sind kurz: was erstellt wurde, wo, ein oder zwei Fragen, eine Empfehlung.

Den Benutzer fragen

Verwende das Frage-Tool, wenn es eines gibt (Claude Code AskUserQuestion: 1–4 Fragen pro Aufruf, 2–4 Optionen, eine Kopfzeile von höchstens 12 Zeichen; Cursor AskQuestion); sonst eine nummerierte Nachricht.

  • Zeige, bevor du fragst. Frage niemals nach einem OK für etwas, das der Benutzer in diesem Chat nicht gesehen hat: Beats und Zeilen sind in der Nachricht selbst, Boards, Standbilder und Entwürfe werden wie unten groß gezeigt. Zu lang für eine Nachricht: zeige es Stück für Stück, frage bei der letzten.
  • Eine Frage pro Element; die empfohlene Option zuerst mit „★ (önerilen)“ / „★ (empfohlen)“ und ihrem Grund; die eigene Antwort des Benutzers ist immer erlaubt. Mehr Kandidaten als Plätze: nummeriere sie auf einem Board, der Rest wird durch Eingabe seiner Nummer ausgewählt; ohne Board behalte die besten und der Rest bleibt als eigene Antwort erreichbar.
  • Eine Runde über dem Limit des Tools wird zu aufeinanderfolgenden Aufrufen; einzeilige Notizen (die Tonlinie, Standardwerte) gehen in eine kurze Nachricht vor dem ersten Aufruf.
  • Die Idee bleibt offen: ohne eine solche, frage sie zuerst als einfache Nachricht; sobald gegeben, werden ihre 2–3 Interpretationen zu den Optionen, aus drei Funken (deal.py deal spark: jeder geleitet von einem Seed, einer echten Sache, die zufällig von außen gezogen wird, mit einem Ort, einer Form und einem Medium, damit nicht zwei Filme am gleichen Ort beginnen), nach dem Vorhersagetest und der Überlappungsprüfung (writing.md §1: frische Helfer; einer schreibt die Filme, die die erste Nachricht jeder erwarten lässt, der andere markiert jeden Kandidaten, der diese oder einen der eigenen Filme dieses Benutzers wiederholt, und ein markierter wird ersetzt). Erfinde eine Geschichte nur bei „sen öner“ / „suggest“.
  • Ein Gate ist eine Frage („OK, weiter ★“ · „Eine Notiz“ · „Ein Tausch“), die Notiz wird in „Sonstiges“ eingegeben.
  • Die Musik ist immer die des Benutzers: in beiden Modi und bei jedem Tempo fragen die ersten Fragen, woher sie kommt (★ eine echte Open-Licence-Aufnahme · eigener Track · in Code geschrieben · keine), nie in eine andere Frage gefaltet; eine Aufnahme wird nach Gehör ausgewählt (2–3 Kandidaten als Dateien gesendet, eine Frage), selbst bei Pace: through; ein langer Film, dessen Akte die Stimmung wechseln, kann ein Stück pro Akt oder Teil nehmen (ein 12-minütiger Film vielleicht 3–4), seine Kandidaten nach Akt in dieser einen Hörfrage gruppiert, während ein Kurzfilm einen Track behält; Musik wird nur in Code gemacht, wenn der Benutzer es gewählt hat. Die Auswahl geht in STATE.md als Music: <recording file / own file / code / none> (user); make.py enthält einen Entwurf, dessen Musik ohne diese Zeile in Code gemacht ist.
  • Das Produktionstempo liegt beim Benutzer (Film-Modus): gefragt mit dem Skript-Gate, wenn die Produktion beginnt, als zweite Frage im selben Aufruf: „Aşama aşama“ (Style-Frame, Typ, Animatic, Entwurf, jeder sein eigenes Gate) oder „Hepsini üret, taslakta göster“ (direkt zum Rohschnitt). ★ das zweite bis etwa 3 Minuten; ★ das erste darüber, wo ein langer Render einen Blick auf den Frame und das Timing zuerst wert ist. In STATE.md geschrieben als Pace: steps oder Pace: through. Bei through oder bei „artık sorma, bitir“ zu jedem Zeitpunkt läuft der Film bis zum Entwurf ohne Frage, außer bei einem echten Hindernis (ein fehlender Schlüssel, Geld, eine gesetzliche Grenze): jede Entscheidung geht zur ★ und wird in STATE.md geschrieben, der Style-Frame und Schlüssel-Stills erreichen den Benutzer als Fortschritt, nie als Fragen, und der Entwurf listet die getroffenen Entscheidungen auf, damit jede eine Notiz sein kann. „Dur, göster“ bringt die Gates zurück.
  • Ein genehmigtes Gate startet den nächsten Schritt in derselben Runde: „Tamam“, „onay“, eine ★-Auswahl oder „devam“ ist das Go für das, was als nächstes kommt, niemals das Ende der Arbeit. Eine Runde endet nur bei einer Frage an den Benutzer, einer Lieferung oder einem Hintergrundjob, der benannt wird, wie lange er läuft.
  • Nichts läuft still: vor einem Schritt, der länger als etwa 30 Sekunden dauert und noch nichts zu zeigen hat (eine Suche, ein Board, ein Render, ein Helfer), sage in einer Zeile, was es tut und wie lange („Ich suche Filmframes für das Style-Board, eine halbe Minute“).
  • Ein langer Job meldet seinen Fortschritt: ein Render oder Helfer, der länger als etwa 2 Minuten läuft, erhält eine Fortschrittsnotiz mit erledigt/gesamt und den verbleibenden Minuten (die eta_s der Statusdatei), wieder etwa auf halbem Weg; „bitti mi?“ wird aus der Statusdatei in einer Zeile beantwortet, niemals mit einer Schätzung.
  • In der Claude-Desktop-App endet eine Runde mit ihrer wrap_up-Box. Ein Gate, bei dem die Runde endet (ein gelieferter Entwurf, ein auf sein OK wartender Plan), ist niemals reiner Text: frage es mit dem Frage-Tool, oder, bei zwei Wahlmöglichkeiten, setze es in wrap_up als ask mit blocked: true und zwei Antwort-Buttons (label 1–3 Wörter, message die Wörter des Benutzers zurück), die ★ zuerst. Die Box zeigt zwei Buttons und lässt den Rest fallen, also geht eine Frage mit mehr Auswahlmöglichkeiten zum Frage-Tool: das Finale des Entwurfs · Notizen · Jury, oder jede Frage mit dem Angebot eines neuen Chats („Yeni sohbette devam ★“ als eine weitere Option); bei dieser Antwort startet der neue Chat bereits mit der Anweisung, fortzufahren (Kleiner Kontext, unten). Die Wache stoppt eine Runde, die mit einem gelieferten Entwurf endet, ohne ihre Frage.
  • Alles, was der Benutzer liest, ist in seiner Sprache, jeder Teil jeder Fragebox und jede kurze Fortschrittsnotiz zwischen den Schritten inbegriffen („Kartı kaydettim, ilk iki sahneyi kuruyorum“, niemals „Card saved, building…“); die englischen Beispiele dieser Datei werden übersetzt, niemals kopiert.
  • Zeige Bilder und Filme groß, niemals in einem Fenster. In Claude Code geht jedes Board, jede Stills-Tafel, jedes Poster und jeder Entwurf zum Benutzer mit SendUserFile (display: "render", status: "normal", einer einzeiligen Bildunterschrift in seiner Sprache): es öffnet sich groß im Seitenpanel der App. Woanders geht sein Pfad (oder die Seite, die das Tool daneben geschrieben hat) in die Nachricht. Die Tools geben aus, was zu zeigen ist („show the user: …“); ein Bild selbst zu lesen zeigt dem Benutzer nur eine winzige Vorschau, niemals genug.
  • Eine Option macht genau das, was ihr Label sagt (niemals „Tamam, temizle“, das auch ein Format speichert). Zwei Entscheidungen sind zwei Fragen.

Start

Hilfe („yardım“, „neler yapabilirsin“, „ne yapabilirim“, „help“, „what can you do“ oder eine erste Nachricht, die nichts Konkretes verlangt: eine Begrüßung, „ne yapabiliriz“): dieses Menü in ihrer Sprache, dann eine Frage mit den vier wahrscheinlichsten Elementen und „Sonstiges“:

Was wir machen können (alles mit Code, am Ende ein MP4):

  1. Kurzfilm oder Animation: eine Idee, ein Gefühl oder ein Ort; in deiner Wunschlänge und -form
  2. Werbung, Produkt- oder Erklärvideo: für deine Marke, dein Produkt oder dein Unternehmen
  3. Musikvideo mit deinem eigenen Song: „Mach ein Video zu diesem Song“ + Songdatei
  4. Ein Film ähnlich einem Referenzvideo: „Mach es wie dieses, aber mit warmen Farben“ + Videodatei
  5. Eigenes Filmmaterial schneiden: Sprecherkopf oder Bildschirmaufnahme: Pausen werden geschnitten, Grafiken hinzugefügt
  6. Neuer Film mit gespeichertem Format: „Einen neuen im gleichen Format wie letztes Mal“
  7. Stile erkunden: Filmlooks und -stile, die zu deiner Idee passen, auf einer Tafel sehen In jedem wird zuerst der Modus gewählt: Schnell (heute fertig) oder Film (Genehmigung in jedem Schritt).

Update („cinecode'u güncelle“, „update cinecode“): git -C KIT pull, dann eine Zeile: öffne einen neuen Chat, damit die neue Version geladen wird.

Direkte Routen. Eine Anfrage, die eine Art von Film nennt, überspringt das Menü: zuerst der Modus und Zweck (ein Aufruf), dann der erste Schritt der Route selbst, dann nur die Fragen, die sie offen lässt.

Der Benutzer sagtRoute
eine Geschichte, Stimmung, Ort oder AnimationsideeErste Fragen
eine Anzeige, ein Produkt, einen Launch, einen Werbespot oder ErklärfilmErste Fragen, Zweck Werbung & Produkt
ein Musikvideo oder sendet ein Liedreferences/music-video.md (zuerst sein Beat-Raster)
„bunun gibi“, „like this one“ oder sendet ein Videoreferences/reference-video.md
eigenes Filmmaterial zum Schneidenreferences/footage-edit.md
„aynı formatta“, „same format“formats.py list → init_film.py <short-name> --format <name> (mit --quick wenn das Format ein Quick-Format ist, wie formats.py list zeigt); quick-mode.md §8
„stillere bakalım“, „show me styles“styles.py suggest "ihre Wörter" --board research/style-board.jpg, dann die ersten Fragen

Erste Fragen: Modus und Zweck

Zuerst lenken (references/steering.md, kurz): lies die Idee gegen das, was im Code am meisten kostet. Wenn sie auf etwas angewiesen ist, das Code schlecht zeichnet (realistische Menschen oder Tiere als Motiv, eine über ihre Länge gestreckte Idee), behält die ★-Interpretation die Idee und ihr Motiv und ändert nur, wie sie gezeigt werden; die Originalidee bleibt als Option mit ihren ehrlichen Kosten, und wenn der Benutzer sie wählt, hilf vollständig.

Frage beide in einem Aufruf; überspringe eine bereits beantwortete („reklam filmi“ nennt den Zweck).

  • Mod / Mode: Hızlı / Quick: Dieser Chat baut den gesamten Film in einer Datei; Fragen nur dort, wo das Briefing eine Lücke lässt; die Karte, zwei Szenen als Stills, dann der Entwurf (ein vollständiges Briefing: der Entwurf zuerst); etwa 3 Genehmigungen, der erste Entwurf eines Kurzfilms in Minuten. Film: Ein Studio-Prozess (Fahrplan, Drehbuch, Style-Frame, Animatic, Entwurf), Recherche, geschichteter Sound, Helfer für die Teile, die parallel laufen; es dauert länger als Quick, daher zitiert die Frage niemals eine Zeit dafür: sie sagt, was der Benutzer sieht und genehmigt. Die ★ folgt der Größe der Arbeit, niemals ihrem Zweck: ★ Quick unter etwa 60 s, für eine Einstellung oder ein paar Szenen, auch Marken- und Kundenstücke; ★ Film ab etwa 60 s mit mehreren Szenen, Recherche oder Archivmaterial, einem Erzähler über viele Kapitel, oder wenn der Benutzer nach dem gestuften Prozess fragt. Die Frage sagt, was jeder vom Benutzer verlangt („Hızlı: erster Entwurf in Minuten, 3 Genehmigungen · Film: zuerst Fahrplan und Drehbuch, dann Produktion Schritt für Schritt oder auf einmal“). Unbekanntes Ziel → ★ Quick (kann später zu Film wechseln, wobei die Beats erhalten bleiben: init_film.py <film> --to-film).

Ein vollständiges Briefing geht direkt an die Arbeit, in beiden Modi: wenn die Eröffnungsnachricht festlegt, was und wann passiert, die Worte, die Länge, das Format und was geliefert wird (ein Kundenbriefing, eine Einstellungsliste, eine Anweisung zu liefern und anzuhalten), wird nichts davon gefragt und kein Gate steht vor dem Entwurf. Die Karte wird in STATE.md gespeichert (ihre Idee, wie der Benutzer sie gab, markiert mit (user)) und in einer kurzen Nachricht gezeigt, der Bau beginnt sofort, und das erste Gate ist der Entwurf selbst (bei einem langen Bau eine Tafel mit Stills seiner Hauptmomente). Eine Anweisung zu liefern und anzuhalten wird wie geschrieben befolgt: liefern, berichten, warten. Nur eine Lücke, die den Film ändert (ein Look, den das Briefing nicht nennt, ein fehlendes Logo), wird einmal gefragt, vor dem Bau.

  • Amaç / Zweck: Sinematik / Cinematic: Eine Geschichte, Stimmung oder künstlerisches Werk, das gefilmt aussieht, nicht gerendert. Reklam & ürün / Werbung & Produkt: um wen es geht und was als nächstes zu tun ist, sind klar. ★ aus der Idee (ein Produkt, eine Marke, ein Launch, eine App oder Sponsor → Werbung; eine Geschichte, ein Ort, ein Gefühl oder eine künstlerische Idee → Kinematografisch). Eine eigene Antwort wird dem näheren Zweck zugeordnet, in einer Zeile gesagt.

Notiere Mode und Purpose in STATE.md, öffne dann references/purpose-cinematic.md oder references/purpose-ad.md (deren Standardwerte und Prüfungen).

Quick-Modus

Alles in references/quick-mode.md. Einrichtung: python3 KIT/scripts/init_film.py <short-name> --quick --films-folder Filmler (das Wort für den Ordner in der Sprache des Benutzers). Kurz: Fragen in einer Runde (die Idee, dann das Medium, die Wahl des Benutzers; dann der Stil, mit dem Auge darin ausgewählt: für einen benannten Look, deine eigenen Messwerte davon neben echten Stills; sonst ein Board) · Recherche im Hintergrund · die Produktionskarte als Text innerhalb von ein oder zwei Minuten (Beats Sekunde für Sekunde, die Regisseurkarte mit Zahlen) · der Look und zwei Szenen als Stills, ein Gate · der Rest in Durchgängen · halbformatiger Entwurf · bis zu zwei Überarbeitungsrunden an Entwürfen · das Finale nach dem OK.

Film-Modus

Alles in references/film-mode.md, mit references/context-protocol.md. Einrichtung: python3 KIT/scripts/init_film.py <short-name> --films-folder Filmler. Sechs gestufte Schritte: Interview → Fahrplan → Drehbuch → Style-Frame und Typ → Animatic → Rohschnitt, dann das Finale; ein Gate, das das Briefing bereits beantwortet, wird übersprungen. Dieser Chat erledigt die Arbeit, für die er den Kontext hält, und übergibt einem Helfer nur einen unabhängigen Teil, der daneben läuft (Sounddesign, während das Bild gemacht wird, Sprachaufnahmen, Recherche, der unabhängige Betrachter) oder ein Kapitel eines Langfilms (context-protocol.md §1); Notizen werden wörtlich pro Runde gespeichert; ein Fehler wird diagnostiziert, bevor etwas neu gebaut wird; bei jedem Gate kann der Benutzer gebeten werden, in einem neuen Chat fortzufahren („STATE.md'den devam et“).

Wo die Dinge sind

KIT = der Ordner dieser Datei: references/, templates/, scripts/, starter/, styles/; nur lesen. PROJECT = ein Ordner pro Film, erstellt von init_film.py, das den richtigen Ort wählt (der Chat-Ordner, wenn er nur Filme enthält, sonst ein Filmordner) und mit der Frage stoppt, die zu stellen ist, wenn es nicht kann (ein Film im Stammverzeichnis eines Filmordners, ein Chat, der innerhalb eines Films gestartet wurde, ein unklarer Ordner). Ein Kurzname kommt vom Titel (Kleinbuchstaben, ASCII, Bindestriche), damit der Ordner ein Regal mit Filmen bleibt, die sich niemals vermischen; sage dem Benutzer den Filmordner in einer Zeile, zuerst in Worten, denen er folgen kann, um ihn zu finden (Mac: Finder › Home › Filmler › ; Windows: Datei-Explorer › › Filmler › ; Linux: Dateien › Home › Filmler › , in ihrer Sprache), dann der Pfad; niemals ein Film in einem Film; betrete niemals einen Filmordner, den dieser Chat nicht erstellt hat, es sei denn, der Benutzer nennt ihn (ein anderer Chat könnte dort arbeiten: init_film.py sagt IN USE, wenn seine Dateien sich ändern

...

[gekürzt für die Übersetzung]

Verwandte Skills