Communitygithub.com

Katha-Studio

Erstellen Sie animierte mythologische, devotional und folkloristische Kurzfilme für YouTube (16:9, 1080p) mit sprechenden Charakteren. Führt durch die Ersteinrichtung (ffmpeg, Chrome, fal- und ElevenLabs-Schlüssel), schreibt das Drehbuch, erstellt konsistente Charaktere, Stimmen, lippensynchrone Szenen, Untertitel, Musik und den fertigen Film samt Thumbnail und YouTube-Text.

Was ist Katha-Studio?

Katha-Studio ist ein KI-Agenten-Skill, der es ermöglicht, vollständige animierte Geschichtenfilme für YouTube zu produzieren – speziell für mythologische, devotional und folkloristische Inhalte. Der Skill führt den Benutzer Schritt für Schritt von der Ersteinrichtung (inkl. Überprüfung von Tools wie ffmpeg und Chrome sowie API-Keys für fal und ElevenLabs) über das Schreiben des Drehbuchs bis hin zur Erstellung konsistenter Charaktere, Sprachaufnahmen, lippensynchroner Dialogszenen, Bildern, Bewegungen, Untertiteln, Musik und dem finalen Film im 16:9-Format mit 1080p-Auflösung. Zudem erstellt er ein Thumbnail und eine YouTube-Beschreibung. Der Skill ist für Claude Code optimiert und verwendet ein Python-Skript (katha.py) ohne zusätzliche Pip-Pakete. Zahlungspflichtige Schritte (z. B. Bilderzeugung, Sprachsynthese) werden klar mit Preisangabe angehalten und nur nach Benutzerzustimmung ausgeführt. Der Skill enthält Referenzdokumente für das Filmformat, die Drehbuchgestaltung und Fehlerbehebung und setzt auf einen strukturierten Workflow mit drei Gates (Drehbuchfreigabe, Charakterfreigabe, Endkontrolle).

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AdityaPratamaS18/katha-studio/tree/HEAD/skills/katha-studio

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Katha-Studio?

Sie erstellen gemeinsam mit dem Benutzer einen fertigen animierten Geschichtenfilm. Ein Film ist ein Ordner mit einer film.json. Das Werkzeug ist python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" (im Folgenden KATHA genannt). Es benötigt keine Pip-Pakete.

Kostenpflichtige Schritte (sheets, images, talk, move) geben den Preis aus und stoppen. Sie verbrauchen nur Geld mit --yes. Führen Sie --yes erst aus, nachdem der Benutzer dem Preis im Chat zugestimmt hat. Der Sprachschritt verwendet das ElevenLabs-Kontingent des Benutzers.

Lesen Sie diese, wenn Sie sie benötigen:

  • references/film-format.md: jedes Feld von film.json.
  • references/story-craft.md: wie man ein Katha-Drehbuch schreibt, das Zuschauer fesselt, und die Szenenregeln.
  • references/troubleshooting.md: bekannte Fehler und Lösungen.

0. Erster Start: geführte Einrichtung

Führen Sie dies aus, wenn der Benutzer neu ist oder wenn ein späterer Schritt aufgrund eines fehlenden Tools oder Schlüssels fehlschlägt.

  1. Führen Sie KATHA doctor aus. Es zeigt OK oder FEHLT für jedes Element an, mit der Lösung.
  2. Geben Sie dem Benutzer für jedes FEHLT nacheinander den genauen Lösungsbefehl für sein System. Warten Sie, bis er sagt, dass es erledigt ist.
  3. Schlüssel: Sagen Sie dem Benutzer, er solle einen fal-Schlüssel (https://fal.ai/dashboard/keys) und einen ElevenLabs-Schlüssel (https://elevenlabs.io/app/settings/api-keys) erstellen und Guthaben auf fal laden (US$10 reichen für einen ersten Kurzfilm).
  4. Sagen Sie dem Benutzer, er solle python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setup in seinem eigenen Terminal ausführen. Bitten Sie ihn niemals, einen Schlüssel in den Chat einzufügen, und geben Sie niemals selbst einen Schlüssel ein.
  5. Führen Sie erneut KATHA doctor aus. Fahren Sie nur fort, wenn BEREIT angezeigt wird.

HINWEIS: Der kostenlose ElevenLabs-Tarif erlaubt keine kommerzielle Nutzung. Ein monetarisierter Kanal benötigt mindestens den Starter-Tarif.

1. Die Geschichte (Gate 1: Der Benutzer genehmigt das Drehbuch)

  1. Fragen Sie nacheinander: die Geschichte, die Sprache, die Länge (beginnen Sie für den ersten Film mit 1 bis 3 Minuten) und den Kanalnamen.
  2. Führen Sie KATHA new <ordner> --title "<titel>" --language <code> aus.
  3. Schreiben Sie film.json: Stil, Charaktere mit einer vollständigen look-Beschreibung, Stimmen (Erzähler plus eine für jeden sprechenden Charakter) und die Szenen. Befolgen Sie references/story-craft.md.
  4. Führen Sie KATHA validate <ordner> aus und beheben Sie jedes FEHLER.
  5. Zeigen Sie dem Benutzer das Drehbuch als Tabelle (id, Sprecher, Art, Zeile, Bild in wenigen Worten) und KATHA cost <ordner>. Ändern Sie es, bis er es genehmigt.

2. Stimmen

  1. Führen Sie KATHA voices --language <code> aus (fügen Sie --gender male, --accent standard oder --search "old" hinzu, um einzugrenzen). Geben Sie dem Benutzer 3 Auswahlmöglichkeiten pro Rolle mit den Vorschaulinks.
  2. Wenn er eine auswählt, setzen Sie die voice_id in film.json unter voices. Eine Bibliotheksstimme funktioniert, ohne sie zum Konto hinzuzufügen.
  3. Nur wenn der Sprachschritt dann mit "voice not found" fehlschlägt, führen Sie KATHA voices --add <voice_id> --owner <besitzer> --name "<rolle>" aus. Dies belegt einen der Sprachplätze des Kontos.
  4. Führen Sie KATHA voice <ordner> <2 oder 3 ids> aus und bitten Sie den Benutzer, audio/raw<id>.mp3 anzuhören, bevor Sie den gesamten Film vertonen.

3. Charaktere (Gate 2: Der Benutzer genehmigt jedes Blatt)

  1. Führen Sie KATHA sheets <ordner> aus, teilen Sie dem Benutzer den Preis mit, und führen Sie es dann mit --yes aus, nachdem er zugestimmt hat.
  2. Betrachten Sie jedes img/char_<id>.png selbst mit dem Lese-Tool. Überprüfen Sie Alter, Gesicht, Kostüm, Farben und die Anzahl der Personen.
  3. Zeigen Sie die Blätter dem Benutzer. Wenn ein Blatt falsch ist, ändern Sie die look-Beschreibung dieses Charakters und führen Sie KATHA sheets <ordner> <id> --yes aus.

Die Blätter sind die Identität des Films. Erstellen Sie niemals Szenenbilder, bevor der Benutzer die Blätter genehmigt hat.

4. Bilder, Stimme, Bewegung

  1. KATHA images <ordner> (Preis), dann mit --yes. Es erstellt nur die fehlenden Bilder.
  2. Betrachten Sie img/contact.jpg und öffnen Sie dann jedes Bild, das falsch aussieht. Überprüfen Sie: die richtigen Charaktere, keine zusätzlichen Personen, kein Text, keine falsche Krone oder Kostüm, und für jede Dialogsendung ein klares, frontal zugewandtes Gesicht mit geschlossenem Mund.
  3. Erstellen Sie ein schlechtes Bild neu: Verbessern Sie seinen image-Prompt, dann KATHA images <ordner> <id> --yes --redo.
  4. KATHA voice <ordner>. Es cached jede Zeile, daher ist ein zweiter Durchlauf kostenlos. Erstellen Sie eine Zeile nach einer Textänderung neu mit KATHA voice <ordner> <id>.
  5. KATHA talk <ordner> (Preis), dann mit --yes. Erst nachdem die Bilder und die Stimme dieser Szenen endgültig sind: Ein neues Bild oder eine neue Stimme erfordert einen neuen Clip.
  6. Betrachten Sie jedes clips/s<id>_check.jpg selbst. Erstellen Sie einen Clip neu, der Buchstaben, falsche Untertitel oder ein verändertes Gesicht zeigt: KATHA talk <ordner> <id> --yes --redo.
  7. Wenn der Film move-Szenen hat: KATHA move <ordner> (Preis), dann mit --yes.

5. Bauen und prüfen (Gate 3: Der Benutzer schaut sich den Film an)

  1. KATHA build <ordner>. Ausgabe: out/<slug>.mp4 und out/thumbnail.jpg.
  2. KATHA check <ordner> muss BESTANDEN anzeigen.
  3. KATHA frames <ordner>, dann betrachten Sie out/frames.jpg und das Thumbnail selbst.
  4. Schreiben Sie out/youtube.md: 3 Titelmöglichkeiten (unter 70 Zeichen, der Geschichtenname plus ein emotionaler Haken), eine Beschreibung (2 Zeilen Zusammenfassung, die Moral, der Quelltext der Geschichte, Kapitel mit Zeitstempeln aus den Szenenlängen), 10 Tags und die Zeile "Erstellt mit KI-Tools" für die Frage zu veränderten Inhalten in YouTube Studio.
  5. Bitten Sie den Benutzer, den gesamten Film mit Ton anzusehen. Nehmen Sie jede von ihm gewünschte Korrektur in ihrem eigenen Schritt vor und bauen Sie dann erneut.

Regeln, die aus echten Fehlern entstanden sind

  • Jede Dialogsendung benötigt eine frontale Nahaufnahme, Kopf und Schultern, Mund geschlossen. Eine Seitenansicht oder ein gesenkter Kopf führt zu schlechtem Lippensync.
  • Lassen Sie den talk-Prompt als Standard ".". Ein Prompt mit der gesprochenen Zeile oder mit Wörtern wie "no subtitles" führte in Tests dazu, dass Kling falsche Untertiteltexte einzeichnete. Kling hat keinen negativen Prompt.
  • Schreiben Sie "ein erwachsener Mann etwa 30 Jahre alt (kein Kind)" für erwachsene Götter. Ohne dies zeichnet das Modell Krishna und andere oft als Kinder.
  • Schreiben Sie, was ein Charakter NICHT tragen darf, wenn eine Szene dies riskiert ("keine Krone, kein Schmuck" für einen armen Brahmanen), da das Modell das Kostüm des anderen Charakters im Bild kopiert.
  • Halten Sie jede Zeile unter etwa 250 Zeichen. Teilen Sie eine lange Rede in 2 Szenen mit 2 Bildern auf.
  • Kopieren Sie nicht das Drehbuch, die Charaktere oder die Thumbnails eines anderen Kanals. Die alten Geschichten sind frei erzählbar; die Erzählung eines anderen Kanals ist es nicht.
  • YouTube kann die Monetarisierung für "unauthentischen Inhalt" (massenhaft erstellte Filme ohne menschliche Arbeit) stoppen. Sagen Sie dem Benutzer, er solle die Geschichten und Struktur variieren und seine eigene Einleitung oder Moral mit seiner eigenen Stimme hinzufügen.

Verwandte Skills