Communitygithub.com

katha-studio

Créez des films d'animation mythologiques, dévotionnels et de contes populaires pour YouTube (16:9, 1080p) avec des personnages parlants. Guide la configuration initiale (ffmpeg, Chrome, clés fal et ElevenLabs), puis écrit le scénario, crée les personnages cohérents, les voix, les plans synchronisés labiaux, les sous-titres, la musique et le film final avec vignette et texte YouTube.

Qu'est-ce que katha-studio ?

katha-studio est un agent spécialisé dans la production complète de films d'animation courts (1 à 3 minutes) pour YouTube, centré sur les thématiques mythologiques, dévotionnelles et les contes populaires. Il prend en charge l'intégralité du pipeline : de la configuration initiale (vérification des dépendances comme ffmpeg, Chrome, et des clés API pour fal.ai et ElevenLabs) à la publication du film final au format 16:9, 1080p. L'agent écrit le scénario, génère des personnages cohérents, leur attribue des voix (narrateur et personnages parlants), produit des plans animés avec synchronisation labiale grâce à l'outil Kling, ajoute des sous-titres et une musique de fond, puis assemble le tout en un fichier MP4. Il inclut également la génération d'une vignette et d'un texte description pour YouTube. Le pipeline est jalonné de points de validation (script, fiches personnages, film complet) où l'utilisateur approuve chaque étape avant de passer à la suivante, garantissant un contrôle créatif tout en automatisant les tâches techniques. Les coûts (génération d'images, animation labiale et mouvements) sont affichés et nécessitent une confirmation explicite via l'option `--yes`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait katha-studio ?

Vous réalisez un film d'animation complet avec l'utilisateur. Un film correspond à un dossier contenant un film.json. L'outil est python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" (appelé KATHA ci-dessous). Il ne nécessite pas de paquets pip.

Les étapes payantes (fiches, images, parole, mouvement) affichent le prix et s'arrêtent. Elles ne dépensent de l'argent qu'avec --yes. Exécutez --yes uniquement après que l'utilisateur a accepté le prix dans le chat. L'étape vocale utilise le quota ElevenLabs de l'utilisateur.

Lisez ceci quand vous en avez besoin :

  • references/film-format.md : chaque champ de film.json.
  • references/story-craft.md : comment écrire un script katha qui retient les spectateurs, et les règles de prise de vue.
  • references/troubleshooting.md : défauts connus et corrections.

0. Première exécution : configuration guidée

Faites ceci lorsque l'utilisateur est nouveau, ou lorsque toute étape ultérieure échoue avec un outil ou une clé manquant(e).

  1. Exécutez KATHA doctor. Il affiche OK ou MANQUANT pour chaque élément, avec la correction.
  2. Pour chaque MANQUANT, donnez à l'utilisateur la commande de correction exacte pour son système, une par une. Attendez qu'il confirme que c'est fait.
  3. Clés : dites à l'utilisateur de créer une clé fal (https://fal.ai/dashboard/keys) et une clé ElevenLabs (https://elevenlabs.io/app/settings/api-keys), et d'ajouter du crédit à fal (10 $US suffisent pour un premier court métrage).
  4. Dites à l'utilisateur d'exécuter python3 "${CLAUDE_SKILL_DIR}/scripts/katha.py" setup dans son propre terminal. Ne lui demandez jamais de coller une clé dans le chat, et ne tapez jamais une clé vous-même.
  5. Exécutez KATHA doctor à nouveau. Ne continuez que si l'état est PRÊT.

REMARQUE : Le plan gratuit d'ElevenLabs n'autorise pas une utilisation commerciale. Une chaîne monétisée nécessite le plan Starter ou supérieur.

1. L'histoire (étape 1 : l'utilisateur approuve le script)

  1. Posez, une question à la fois : l'histoire, la langue, la durée (commencez par 1 à 3 minutes pour un premier film) et le nom de la chaîne.
  2. Exécutez KATHA new <dossier> --title "<titre>" --language <code>.
  3. Écrivez film.json : le style, les personnages avec une apparence complète chacun, les voix (narrateur plus une pour chaque personnage parlant), et les scènes. Suivez references/story-craft.md.
  4. Exécutez KATHA validate <dossier> et corrigez chaque ÉCHEC.
  5. Montrez à l'utilisateur le script sous forme de tableau (id, intervenant, type, réplique, image en quelques mots) et KATHA cost <dossier>. Modifiez jusqu'à ce qu'il l'approuve.

2. Voix

  1. Exécutez KATHA voices --language <code> (ajoutez --gender male, --accent standard ou --search "old" pour affiner). Donnez à l'utilisateur 3 choix pour chaque rôle avec les liens de prévisualisation.
  2. Lorsqu'il choisit, mettez le voice_id dans film.json dans voices. Une voix de bibliothèque fonctionne sans l'ajouter au compte.
  3. Uniquement si l'étape vocale échoue alors avec « voix introuvable », exécutez KATHA voices --add <voice_id> --owner <owner> --name "<rôle>". Cela utilise un des emplacements de voix du compte.
  4. Exécutez KATHA voice <dossier> <2 ou 3 ids> et demandez à l'utilisateur d'écouter audio/raw<id>.mp3 avant de faire parler l'ensemble du film.

3. Personnages (étape 2 : l'utilisateur approuve chaque fiche)

  1. Exécutez KATHA sheets <dossier>, dites le prix à l'utilisateur, puis exécutez avec --yes après son accord.
  2. Regardez vous-même chaque img/char_<id>.png avec l'outil de lecture. Vérifiez l'âge, le visage, le costume, les couleurs et le nombre de personnes.
  3. Montrez les fiches à l'utilisateur. Si une fiche est incorrecte, modifiez l'apparence de ce personnage et exécutez KATHA sheets <dossier> <id> --yes.

Les fiches sont l'identité du film. Ne jamais créer d'images de scène avant que l'utilisateur n'ait approuvé les fiches.

4. Images, voix, mouvement

  1. KATHA images <dossier> (prix), puis avec --yes. Il ne crée que les images manquantes.
  2. Regardez img/contact.jpg, puis ouvrez chaque image qui semble incorrecte. Vérifiez : les bons personnages, pas de personnes supplémentaires, pas de texte, pas de couronne ou costume erroné, et pour chaque scène de dialogue un visage clair de face avec la bouche fermée.
  3. Refaites une image incorrecte : améliorez son prompt image, puis KATHA images <dossier> <id> --yes --redo.
  4. KATHA voice <dossier>. Il met en cache chaque réplique, donc une seconde exécution est gratuite. Refaites une réplique après un changement de texte avec KATHA voice <dossier> <id>.
  5. KATHA talk <dossier> (prix), puis avec --yes. Uniquement après que les images et la voix de ces scènes sont finalisées : une nouvelle image ou une nouvelle voix nécessite un nouveau clip.
  6. Regardez vous-même chaque clips/s<id>_check.jpg. Refaites un clip qui montre des lettres, de faux sous-titres ou un visage qui a changé : KATHA talk <dossier> <id> --yes --redo.
  7. Si le film comporte des scènes de mouvement : KATHA move <dossier> (prix), puis avec --yes.

5. Construction et vérification (étape 3 : l'utilisateur regarde le film)

  1. KATHA build <dossier>. Sortie : out/<slug>.mp4 et out/thumbnail.jpg.
  2. KATHA check <dossier> doit afficher RÉUSSI.
  3. KATHA frames <dossier>, puis regardez out/frames.jpg et la vignette vous-même.
  4. Écrivez out/youtube.md : 3 propositions de titres (moins de 70 caractères, le nom de l'histoire plus un accroche émotionnelle), une description (2 lignes de résumé, la morale, le texte source de l'histoire, des chapitres avec horodatages basés sur les longueurs des scènes), 10 tags, et la ligne « Réalisé avec des outils d'IA » pour la question sur le contenu modifié dans YouTube Studio.
  5. Demandez à l'utilisateur de regarder le film complet avec le son. Effectuez chaque correction demandée à son étape respective, puis reconstruisez.

Règles issues de défauts réels

  • Chaque scène de dialogue nécessite un gros plan de face, tête et épaules, bouche fermée. Une vue de profil ou une tête baissée donne une mauvaise synchronisation labiale.
  • Laissez le prompt de dialogue par défaut à « . ». Un prompt avec la réplique prononcée, ou avec des mots comme « pas de sous-titres », a fait dessiner de faux sous-titres par Kling lors des tests. Kling n'a pas de prompt négatif.
  • Écrivez « un homme adulte d'environ 30 ans (pas un enfant) » pour les dieux adultes. Sans cela, le modèle dessine souvent Krishna et d'autres comme des enfants.
  • Écrivez ce qu'un personnage ne doit PAS porter lorsqu'une scène le risque (« pas de couronne, pas de bijoux » pour un pauvre brahmane), car le modèle copie le costume de l'autre personnage dans le cadre.
  • Gardez chaque réplique sous environ 250 caractères. Divisez un long discours en 2 scènes avec 2 images.
  • Ne copiez pas le script, les personnages ou les vignettes d'une autre chaîne. Les vieilles histoires sont libres d'être racontées ; la version d'une autre chaîne ne l'est pas.
  • YouTube peut stopper la monétisation pour « contenu inauthentique » (films produits en masse sans travail humain). Dites à l'utilisateur de varier les histoires et la structure, et d'ajouter sa propre introduction ou morale avec sa propre voix.

Skills associés