Communitygithub.com

film-academy

Montre à un agent comment planifier, construire ou couper une « film academy » de sorte que le résultat concret soit un montage basé sur ffmpeg. La procédure passe par Film academy, Commencez ici : décrivez le produit, exécutez deux commandes, La pipeline manuelle (ce que fait `make`, étape par étape). Utilisez ce skill lorsqu'une nouvelle mission fait appel à ce métier.

Qu'est-ce que film-academy ?

Ce skill permet à un agent IA de réaliser un film, une démo, un lancement ou une vidéo de marque à partir de scènes HTML. Le rendu se fait image par image via Chromium, le montage est assuré par ffmpeg, la musique est coupée sur les temps de mesure à -14 LUFS, et une "gate" numérique (basée sur la longueur des plans, les images statiques, les mots par carte, et les règles de montage) ainsi que les notes textuelles du client décident si une coupe est prête. Le skill suit une approche de développement logiciel : le film est écrit comme une page web, mesuré et corrigé de manière itérative. Il inclut des outils pour créer un projet (`film.py new`), le rendre (`film.py render`), mixer le son (`film.py mix`), verrouiller la qualité (`film.py gate`), et gérer les retours clients (`film.py note`, `film.py tick`). Le processus est conçu pour produire des films optimisés pour les réseaux sociaux (6-15 secondes) ou des films "hero" (30-60 secondes), avec une attention particulière à la légalité des licences musicales et des assets. Le skill insiste sur l'importance de ne pas inventer de revendications ou de chiffres, et de mesurer les références existantes avant de créer.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tincurik/film-academy/tree/HEAD

Demander à votre IA préférée

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

Documentation

Film academy

Une façon de faire un film construit, mesuré et corrigé comme du code. Vous écrivez le film comme une page web, le moteur de rendu le filme, le mixeur pose le son sur ses temps, la gate refuse une coupe devenue plus lente ou plus morte que la précédente, et tout ce que le propriétaire dit du film est conservé mot pour mot et doit être répondu avant qu'une coupe ne passe.

Toutes les commandes s'exécutent depuis le dossier de ce skill (python film.py ...). Nécessite ffmpeg, Python 3.9+, pip install playwright && playwright install chromium. python film.py check indique ce qui manque. OCR (tesseract) est optionnel.

Commencez ici : décrivez le produit, exécutez deux commandes

Quand le propriétaire décrit un produit et veut un film :

  1. Collectez uniquement ce que vous ne pouvez pas inventer : le nom, la promesse unique (une phrase), 2-4 faits vraiment vrais (lignes de preuve), un nombre réel s'il y en a un, la demande unique (une URL), et si le produit est une page web ou une application native/phone (demandez alors un enregistrement d'écran, voir ci-dessous). N'inventez jamais une affirmation ou un chiffre : le film montre ce qu'on lui donne. Demandez en un seul message ; si aucune durée n'est donnée, 6-15 s est une coupe sociale, 30-60 s un film héroïque.
  2. python film.py new "<name>" --promise "<promise>" --points "Label=valeur|Label=valeur" [--number "40%" --number-label "..."] [--slam "Pas de configuration."] [--action "Un tap"] --url <url> [--music track.mp3 --drop-bar N] [--recording rec.mov] écrit films/<slug>/film.json et la page.
  3. python film.py make films/<slug> : rendu, son, gate ; chaque make est une construction numérotée (v1, v2, ...) verrouillée contre la précédente. --master pour 1920x1080 à 60 i/s.
  4. Regardez-la (python film.py sheet <film.mp4> films/<slug>/sheet.jpg, puis lisez l'image ; vous ne pouvez pas lire la vidéo) et dites au propriétaire où se trouve le mp4.
  5. Le goût est le leur. Le premier tour est compétent et générique. Demandez-leur de la regarder et de dire ce qui ne va pas ; stockez chaque remarque mot pour mot dans ce même tour (film.py note "<leurs mots>" --source "qui, date" --store films/<slug>/film-notes.json), modifiez film.json ou film.html, cochez chaque note par rapport à la nouvelle construction (film.py tick N1 --film <mp4> --where 0:04 --store ...), refaites make. La gate refuse une construction avec une note non cochée, et une construction plus lente ou plus statique que la précédente.
  6. Dites clairement au propriétaire : la gate détecte les coupes mortes ou qui empirent mais ne peut pas juger le goût ; et le travail consomme leurs tokens Claude (un premier film coûte des dizaines de milliers de tokens, chaque tour de correction 10-30k ; les scènes personnalisées coûtent plus), donc corrigez plusieurs choses par tour et lisez une seule planche contact plutôt que plusieurs images fixes.

Une application native ou phone (pas une page web) : demandez un court enregistrement d'écran (5-10 s, une tâche, notifications éteintes, rien de personnel à l'écran) et exécutez python film.py import-recording rec.mov films/<slug> --start 2 --seconds 6. Cela devient des images que la page montre dans une fenêtre, à la place de la carte dessinée.

Consultez playbook.md avant de modifier la page au-delà de film.json (d'abord les sections structure et édition, puis le son avant de choisir la musique). Musique : le placeholder généré est le défaut ; ne livrez jamais une piste dans un dépôt, et une piste fournie par le propriétaire nécessite une licence qui lui permet de publier le film.

La pipeline manuelle (ce que fait make, étape par étape)

La boucle

  1. Brief, en un seul passage. Type (promo, explicatif, coupe sociale), la promesse unique que fait le film (une phrase), durée, où il est diffusé, et ce que vous êtes autorisé à montrer (uniquement le matériel que le propriétaire peut publier ; aucune donnée dont vous ne pouvez pas nommer le droit d'utilisation). Si le propriétaire n'a donné aucune durée, 30-60 s pour un film héroïque, 15 s pour les réseaux sociaux. Ne demandez pas comment le film doit être fait ; c'est votre travail.
  2. Références avant les pixels. Obtenez 2+ films dans le même espace (regardez-les, téléchargez uniquement ce que vous pouvez conserver pour étude privée) et exécutez python film.py measure ref1.mp4 ref2.mp4. Leur durée moyenne de plan, part statique et mots par carte sont votre référence. Consultez playbook.md : les groupes structure et édition avant d'écrire, le groupe son avant de mixer. Ne copiez jamais une référence ; prenez ses chiffres et ses techniques.
  3. Écrivez le film comme une page HTML (à partir de academy/template.html, que film.py new copie dans le projet ; il définit aussi window.timeline() et window.cards() pour que la gate connaisse les vrais plans et le texte des cartes). Le contrat : window.seek(t) dessine la page au temps t comme une fonction pure de t (pas de minuteurs, pas d'animation CSS automatique), window.duration() retourne les secondes, window.cues() retourne [{t, sfx, db}] pour les sons qui appartiennent à une image, window.ready est une promesse pour les polices et images, window.MISSING liste les assets qui n'ont pas pu être chargés (toute entrée échoue le rendu). Placez les débuts de scène sur la grille des temps de la musique (bar = beats_per_bar * 60 / bpm). Ouvrez sur le payoff (l'image 0 est une image), une promesse, un moment clé tard, la marque tôt et à nouveau sur la carte de fin.
  4. Regardez avant de rendre. Un modèle ne peut pas lire la vidéo : python film.py stills film.html out/stills 0,2.5,5 et lisez les PNG ; python film.py sheet film.mp4 sheet.jpg après un rendu donne une image par seconde sur une seule image. Corrigez ce que vous voyez.
  5. Rendu. python film.py render film.html out/film.mp4 --fps 30 --size 1280x720 --workers 2 (utilisez --fps 60 --size 1920x1080 pour le master). N workers Chromium filment chacun une tranche ; un worker planté ou un asset manquant échoue tout le rendu, jamais un film plus court. Les repères de la page sont écrits dans out/film.cues.json.
  6. Son. python film.py mix out/film.mp4 out/final.mp4 --plan plan.json --music track.mp3 --sfx sfx_dir --cues out/film.cues.json. Le plan liste les segments musicaux par mesure (track_bar -> film_bar, bars) pour que chaque saut atterrisse sur un temps fort ; le dernier accord résonne sous la carte de fin. La loudness atteint -14 LUFS, le pic réel -1 dBTP (loudnorm en deux passes) et est mesurée après. Musique : apportez la vôtre, avec une licence qui vous permet de publier le film (ne livrez jamais une piste dans un dépôt) ; effets sonores en <name>.wav. Pas de voix par défaut ; une voix synthétique plate est pire que rien.
  7. Films longs en parties. Donnez à chaque partie sa propre page et son propre rendu, afin que plusieurs personnes ou agents puissent travailler en parallèle, puis python film.py join p1.mp4 p2.mp4 p3.mp4 --out film.mp4 --dissolve 0.5 (le .cues.json de chaque partie se déplace sur l'horloge du film entier) et mixez une fois sur l'ensemble.
  8. Gate. python film.py gate --film out/final.mp4 --against previous.mp4 --refs ref1.mp4 ref2.mp4 --timeline times.json --bpm 120. Elle s'arrête (exit 5) lorsque la coupe est plus lente que la précédente, plus statique, ou a une rafale de petits plans / coupes sur chaque temps ; elle avertit sur les mots par carte et la loudness. Le score de scène de ffmpeg voit à peine les transitions douces, donc donnez les vrais temps de coupe dans times.json ({"final": [2.0, 4.0, ...]}, indexé par le nom du fichier). Corrigez le film, rendez, gatez à nouveau. Un film qui ne bat jamais la coupe précédente n'est pas terminé.
  9. Les notes lient chaque coupe. Chaque fois que le propriétaire dit quoi que ce soit sur le film, stockez-le dans ce même tour, textuellement : python film.py note "<leurs mots exacts>" --source "qui, date" [--means "votre lecture"]. Avant une gate, cochez chaque note par rapport au fichier exact avec l'endroit où elle est répondue : python film.py tick N1 --film out/final.mp4 --where 0:04 (un timestamp ou plan 7). film.py gate refuse (exit 6) tant qu'une note n'a pas de coche pour le hash de ce fichier ; un nouveau rendu ou un changement de musique est un nouveau fichier et nécessite de nouvelles coches. python film.py notes --film out/final.mp4 liste ce qui est ouvert. Leurs mots ne sont jamais modifiés ; votre lecture va dans --means.
  10. Livrez le film fini. Le propriétaire voit la coupe finale (master pleine résolution, images fixes pour l'affiche), pas les animatiques, storyboards ou versions à moitié construites ; s'il a demandé à voir un brouillon, c'est son choix, pas une valeur par défaut.

Règles qui ont tenu

  • Le goût du propriétaire prime sur tout score : la gate détecte les régressions et les coupes mortes, elle ne choisit pas le meilleur film. Quand le propriétaire dit ce qui est bien ou mal dans un film, ajoutez-le au playbook pour le suivant.
  • Ne reconstruisez jamais une partie de la pipeline qu'une mesure couvre déjà : mesurez d'abord (film.py measure), puis modifiez.
  • Les corrections vont dans ce dossier (le playbook, le template de page, le plan), pas dans une invite qui sera perdue après la session.
  • Aucun film de référence, clip ou piste sous licence ne va dans un dépôt : uniquement des chiffres.

Fichiers

FichierDescription
film.pyla ligne de commande : new, make, import-recording, check, render, stills, join, mix, measure, gate, sheet, note, tick, notes
academy/project.py, academy/template.htmlnew/make : le projet film, la page pilotée par configuration
academy/render.pyrendu image par image Chromium (tranches parallèles, ffmpeg)
academy/mix.pycoupe musicale sur les temps, hits sur les repères, loudnorm en deux passes vers -14 LUFS
academy/join.pyparties jointes avec fondus, repères fusionnés
academy/gate.pyles mesures et vérifications
academy/notes.pynotes textuelles, coches liées à un hash de fichier
playbook.md43 techniques sourcées et les chiffres de la gate
data/chiffres de référence (18 films publiés) et limites de coupe-craft (205 films), uniquement des chiffres
example/un film original de 10 s (bash example/build.sh) : new puis make sur un produit inventé

Skills associés