Communitygithub.com

storyboard-film

Rédige l'histoire d'un film produit sous forme de beats (ce que le spectateur voit, les mots à l'écran, la voix, le son, la raison du beat et la preuve de chaque affirmation) et l'envoie au propriétaire sous forme d'un storyboard d'une page avec des vignettes pour révision, avec 2 à 4 directions lorsque l'histoire est ouverte. Étape 2 du film produit, et le format de révision est réutilisé pour la voix off. À utiliser lors de la planification de l'histoire, du plan de tournage ou du script d'un film de lancement/promotion, ou lorsque le propriétaire dit "donne-moi un storyboard", "donne-moi des directions", "je vais réviser et décider".

Qu'est-ce que storyboard-film ?

Ce skill est conçu pour la création de storyboards de films produits, en particulier pour les films de lancement ou de promotion. Il guide l'utilisateur dans la rédaction de l'histoire sous forme de "beats" (unités narratives), en spécifiant pour chaque beat ce que le spectateur voit, les mots à l'écran, la voix off, les effets sonores, la raison d'être du beat et la preuve de chaque affirmation. Le skill produit un storyboard d'une page avec des vignettes, prêt à être révisé par le propriétaire du projet. Il prend en charge les plateformes où des fichiers peuvent être envoyés et affichés, et est particulièrement utile lors de la planification de l'histoire, du plan de tournage ou du script, ou lorsque le propriétaire demande explicitement un storyboard ou des directions. Le skill inclut des vérifications de qualité basées sur des leçons tirées de brouillons antérieurs, garantissant que l'histoire est spécifique, basée sur des preuves réelles, et évite les malentendus. Après approbation, le fichier storyboard.json reste la source de vérité pour le timing des plans et le placement des phrases dans la voix off.

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

Demander à votre IA préférée

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

Documentation

Storyboard film

Le storyboard est l'endroit où la plupart des corrections du propriétaire devraient avoir lieu, car changer une phrase coûte une minute et changer un plan rendu coûte une heure. Envoyez-le avant de construire, et renvoyez-le (avec des vignettes réelles) avant d'enregistrer une voix.

Ce qui fait une bonne histoire de film produit

Vérifiez chaque beat par rapport à ces critères. Chacun provient d'un brouillon rejeté (voir product-film/references/lessons.md).

  1. La douleur du spectateur, dans son quotidien. Nommez l'habitude ou la contrariété comme le spectateur le dirait. Testez la phrase : après l'avoir entendue, que penserait un inconnu que nous vendons ? "Les mêmes chiffres chaque jour" a fait penser à un logiciel d'analyse, donc cela a échoué.
  2. Les rôles ne peuvent pas être mal interprétés. Montrez les vrais outils avec leur nom et leur logo. Vérifiez chaque paire de lignes adjacentes : "Demandez à l'IA que vous payez déjà. Elle s'appelle Nimbet." fait passer le produit pour l'IA. Attachez le nom à ce que fait le produit.
  3. Spécifique, pas abstrait. "Votre IA" comme étiquette n'était pas clair ; la véritable fenêtre de Claude Desktop était claire. Un vrai tableau de bord Stripe est mieux qu'une boîte étiquetée "Revenus". 4 La variété a besoin d'espace. Si la promesse est "tout ce dont VOUS avez besoin", montrez 8+ types de personnes (une carte plein écran chacune), puis un mur de nombreux articles mélangeant travail, vie et loisirs (jeux, animaux de compagnie, autocollants). Moins d'environ 6 donne l'impression d'être "coincé". Cela nécessite 45 à 65 secondes ; 20 secondes, c'est trop court.
  4. Réel seulement. Chaque élément, capacité et affirmation fonctionne dans le produit aujourd'hui. Remplissez le champ claim avec l'endroit où cela est prouvé (un fichier, un document, un test). Si l'histoire a besoin de quelque chose que le produit ne peut pas faire, soulevez-le avec le propriétaire : construisez-le ou supprimez-le.
  5. Comprenez chaque plan avant d'écrire à son sujet. Écrivez le why pour chaque beat. Si vous ne pouvez pas dire à quoi sert un plan, demandez au propriétaire. (Une ligne sur un animal de compagnie a été écrite sur un plan qui montrait en fait les widgets personnalisés des gens.)
  6. Chaque ligne lisible. Texte à l'écran : ~0,3 s par mot + 1 s, jamais moins de 1,5 s entièrement visible.
  7. Terminez sur l'action, avec le nom et l'URL, et la ligne d'utilisation nominative si une marque est apparue.

Étapes

  1. Lisez le brief approuvé, reference/NOTES.md, le produit et le site en ligne, et le fichier de leçons.
  2. Rédigez les beats dans storyboard.json (format dans l'en-tête du script) :
    { "title": "…", "subtitle": "draft 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    Avant que le film n'existe, still peut être un croquis rapide ou une image de la référence avec une note ; après, c'est toujours une image RENDUE réelle (node scripts/render.mjs --at …).
  3. Directions. Lorsque l'angle est ouvert, écrivez 2 à 4 directions qui diffèrent par l'idée, pas par le wording (par exemple « Conseils que le spectateur peut utiliser », « La contrariété quotidienne », « Ce que votre IA sait déjà de vous »). Pour chacune : idée en une ligne, le risque, et à qui cela convient. Mettez votre choix en premier.
  4. Générez la page :
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    Elle s'ouvre avec la voix off de chaque direction sous forme d'un paragraphe (la lecture les yeux fermés), puis chaque beat avec son image.
  5. Auto-vérification avant d'envoyer : lisez uniquement le paragraphe de transcription. A-t-il un sens les yeux fermés ? Une ligne qui pourrait être mal interprétée ? Une liste « votre X, votre Y », une triade, ou un mot répété ? Une affirmation sans preuve ?
  6. Porte de révision. Envoyez la page (SendUserFile, affichage du rendu) et demandez : quelle direction, et quels beats modifier. Ajoutez les questions de l'étape 2 de product-film/references/question-bank.md (ouverture, comment les rôles sont montrés, format des personas, personnages, réalisme de l'interface). Attendez un oui clair. Validez storyboard.json.

Après approbation

Conservez storyboard.json comme source de vérité : le timing des plans dans le film et le placement des phrases dans la voix off proviennent tous les deux de ce fichier. Lorsque le propriétaire modifie un beat plus tard, modifiez-le ici d'abord et regénérez la page.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Skills associés