CommunityImagegithub.com

galloisforge/forge-story

Transforme une idée, une chanson, un poème ou un mythe en bible de l'histoire, un scénario minuté et un plan de tournage ajusté à un budget de crédits, le tout rédigé en YAML que les outils valident, chiffrent et calent sur la musique. Utilisez cette compétence lorsque l'utilisateur a une idée à transformer en court métrage, film peint, clip vidéo ou livre illustré ; souhaite un pitch, un synopsis, une bible, un séquencier, un storyboard ou un plan de tournage ; demande combien de plans ou quelle durée ses crédits permettent ; ou veut resserrer une histoire existante pour qu'elle fonctionne, même sans jamais prononcer 'plan de tournage'.

Qu'est-ce que forge-story ?

Cette compétence guide les utilisateurs pas à pas dans la création d'un court métrage animé (ou film peint, clip, livre) en partant d'une simple idée jusqu'à un plan de tournage validé et budgétisé. Elle produit trois livrables : une bible détaillant l'histoire, les personnages et la palette de couleurs ; un scénario minuté seconde par seconde ; et un plan de tournage en YAML. Le processus s'appuie sur six moteurs narratifs éprouvés (relation, défaut, choix déchirant, retournement, miroir, image double) pour garantir une histoire solide, puis dimensionne le film en fonction des crédits disponibles via des calculs intégrés. Destinée aux outils IA comme Claude Code, Cursor ou Codex, elle automatise la validation et l'ajustement budgétaire, ce qui la rend idéale pour les créateurs souhaitant passer rapidement de l'idée à un plan de production concret et cohérent.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gallowforge/filmforge/tree/HEAD/skills/forge-story

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

FilmForge Story

L'histoire vient en premier : rien n'est peint, composé ou acheté tant que le film n'existe pas sur papier, minuté à la seconde et chiffré au crédit. Cette compétence écrit trois fichiers : story-bible.md, screenplay.md, shotlist.yaml (modèles dans templates/). La validation est réussie lorsque le plan de tournage est valide et que son plan tient dans les crédits.

Chemins : scripts/, templates/ et config/ ci-dessous sont des dossiers à l'intérieur de cette compétence (le répertoire de base affiché lors de son chargement), placés par ./install.sh. En travaillant depuis un clone du dépôt, ils sont tools/, templates/ et config/ à sa racine.

Étape 1. Pitch et thèse

  • Pitch : une phrase, qui veut quoi et ce que ça lui coûte.
  • Thèse : une phrase que la fin prouve.

Si l'un ou l'autre nécessite deux phrases, l'histoire n'est pas encore trouvée. Continuez à travailler ici ; tout ce qui suit en hérite.

Étape 2. Le cœur : six moteurs

Les grands courts métrages animés font les mêmes choses. Remplissez chaque ligne ; un film qui ne peut pas en remplir une manque une partie.

MoteurTest
Une relationDeux personnages dont parle le film. Tous les autres les servent.
Un défaut, avec un prixLe défaut du héros coûte quelque chose de réel à quelqu'un, à l'écran.
Un choix qui déchireLe héros renonce à ce qu'il voulait, de sa propre main.
Un retournementCe que le public croyait n'est pas la vérité, et la vérité a été semée.
Un miroirUne image qui ment tôt et dit la vérité tard.
Une image, deux foisUne composition ouvre et ferme le film, changée par tout ce qui se passe entre les deux.

Exemple travaillé (La Phalène de la Lanterne, l'exemple texte du dépôt, 36 s) : une relation, une fille du phare et la phalène braise, la première chose chaude qu'elle ait tenue de tout l'hiver. Un défaut avec un prix : elle veut garder la chaleur, et pendant qu'elle la protège, le bateau dérive vers les rochers. Un choix : elle ouvre les mains vers la lampe éteinte et laisse partir la phalène dedans. Un retournement : la phalène ne s'éteint pas ; à l'aube, le verre de la lampe est couvert d'une centaine de petites phalènes de braise. Un miroir : son reflet dans la lentille de la lampe, seule et éclairée par la phalène, puis perdu dans la lumière du faisceau. Une image deux fois : le phare éteint la nuit ouvre le film, le phare chaud à l'aube le ferme.

Étape 3. Présentations et aboutissements

Un tableau où rien n'apparaît qu'une seule fois. Chaque ligne : ce qui est planté (plan), ce qui est abouti (plan). Si une image n'a pas d'aboutissement, coupez-la ou donnez-lui-en un. Lignes de La Phalène de la Lanterne : la lampe éteinte dans le premier plan / le même plan à l'aube, la lampe chaude ; la lanterne vide qu'elle porte partout / elle reste au sol une fois la phalène partie ; une phalène sur le bout du doigt / cent phalènes sur le verre ; pas d'or chaud nulle part / le faisceau flamboie or.

Étape 4. La scénographie couleur

Une ligne par scène : plage horaire, 3 à 5 couleurs, la sensation. Ajoutez les règles qui portent du sens ("pas d'or chaud avant que la lampe soit allumée", "la seule couleur chaude avant que la lampe soit allumée est l'orange de la phalène", "pas de bleu dans le ciel avant l'aube"). Les règles deviennent des entrées forbid dans le registre de continuité, mesurées sur chaque peinture.

Étape 5. Le scénario, minuté

  • Scènes avec plages horaires ; plans avec début, durée, cadrage, et seulement ce qu'une caméra peut photographier, au présent. Une action qui ne peut être photographiée n'est pas dans le film.
  • Sous chaque scène, ce que fait la musique (instruments, énergie, un hit nommé, un silence écrit). Le scénario de La Phalène de la Lanterne place "un drone grave, un coup doux sur chaque temps. Froid et seul." sous L'Obscurité, et "le hit à 0:24, puis des accords chauds et pleins" sous La Lumière. Si la musique existe déjà (une chanson, une pièce pour piano), l'histoire traverse ses sections dans l'ordre, une ligne d'ambiance sous chacune, et les plans ou pages tournent avec elle.
  • Mots : dites seulement ce que les images ne peuvent pas (qui parle, pourquoi ils partent, qui meurt, ce que signifie la fin). Le sans-paroles est une force : il joue pour tout le monde, partout. La narration est écrite à la main à l'écran ou parlée ; dans les deux cas, elle est minutée en temps filmique plus tard (forge-sound).

Étape 6. Dimensionner le film aux crédits

credits_peinture = credits x 0.95 - feuilles - plaques - épreuves - partition
peintures       = plancher(credits_peinture / (prix x 1.3))        # 1.3 = marge de reprise
durée            = peintures x maintien_moyen                     # maintien peint : 4 à 6 s chacun

Exemple travaillé : 70 crédits (66,5 dépensables), deux feuilles et une plaque (8,25, environ 11,8 avec marges), une partition de 64 s (9,28) : environ 45,4 restants pour les peintures, donc 12 peintures à 2,75 avec la marge : un film de 60 secondes à 5 s de maintien. La Phalène de la Lanterne tourne 6 plans en 36 s ; budget.py le planifie à 39,08 sur 66,50 dépensables, avec 27,42 de marge après ce qui est déjà dépensé : de la place pour 7 peintures supplémentaires avec reprises.

Règles lors du dimensionnement :

  • Plans héroïques d'abord : nommez les 2 à 4 plans qui doivent faire ressentir quelque chose aux gens. Ils sont peints comme épreuves avant tout le reste.
  • Mouvement réel uniquement là où rien d'autre ne fonctionne (vol, une transformation qui est le point culminant). Ailleurs, poses clés qui claquent (poses: 2) et vie en post-production.
  • Réutilisez une plaque ou une peinture là où l'histoire le permet (kind: reuse) : le moteur de l'image double est gratuit.

Étape 7. Le plan de tournage

Écrivez shotlist.yaml (schéma : references/shotlist-schema.md). Chaque plan : id, scène, dur, type, cadrage, action, personnages, refs (chaque fiche personnage), cut_on, et là où le brief musique nomme un hit narratif, pin. Ensuite :

python3 scripts/shotlist.py validate shotlist.yaml
python3 scripts/budget.py shotlist.yaml --production production.yaml

Itérez jusqu'à ce que validate n'affiche aucune erreur et que budget affiche FITS. Avertissements à traiter : maintien peint sous 1,5 s ou au-dessus de 10 s, narration plus rapide que 2,4 mots par seconde, un personnage dans le cadre sans sa fiche attachée.

Format de sortie

  1. story-bible.md : pitch, thèse, les six moteurs, monde, personnages (identifiant, apparence, désir, mouvement), accessoires et états, présentations et aboutissements, scénographie couleur, règles de production.
  2. screenplay.md : scènes avec temps, notes musicales, plans avec début, durée, cadrage, action, paroles.
  3. shotlist.yaml : valide, correspond.
  4. Un court rapport : durée, nombre de plans, crédits planifiés contre disponibles, les plans héroïques, l'unique risque.

Liste de vérification

  • Le pitch et la thèse font une phrase chacun
  • Les six moteurs sont remplis ; chaque présentation aboutie
  • Scénographie couleur avec ses règles
  • Chaque plan est photographiable ; chaque action est sous sa musique
  • shotlist.py validate : aucune erreur
  • budget.py : FITS, réserve intacte
  • Plans héroïques nommés

Tableau de réparation

SymptômeCorrectif
La fin ne fonctionne pasLe choix est absent ou fait pour le héros ; ou le retournement n'a pas été semé. Revérifiez les moteurs 3 et 4
On dirait un diaporamaLes actions décrivent des états, pas des changements ; réécrivez chaque action comme quelque chose qui change dans le cadre
Trop cherMoins de plans, maintien plus long ; réutilisez les plaques ; poses clés au lieu de vidéo ; puis coupez les plans de priorité 3
Avertissements de narrationMoins de mots, ou laissez la ligne courir sur la coupe suivante (la narration vit en temps filmique)
Les personnages ne semblent pas les mêmesCe n'est pas un défaut de l'histoire : forge-style-lock (fiches, ancres, verrous d'échelle)

Références

  • references/story-engine.md : les six moteurs en profondeur, avec La Phalène de la Lanterne détaillé
  • references/shotlist-schema.md : chaque champ du plan de tournage, ses valeurs et quel outil le lit

Individual skills in this repo

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

gallowforge/forge-deliver

FilmForge deliver: encodes and checks every deliverable of a finished film or book (4K master, 1080p for posting, phone copy, cover stills, print-book PDF, making-of, localised editions) with exact ffmpeg settings, verifies streams, loudness and picture-to-music sync on the finished files, then builds the production archive with a SHA-256 completeness proof that anyone can re-verify later, and proves backup copies byte for byte. Use this skill whenever the user wants to export, encode or render final versions, post a film, make a phone copy or covers, produce a print PDF or a translated edition, back up or archive a production, or prove that an archive or copy is complete.

gallowforge/forge-director

FilmForge director: runs an AI film production end to end (story, style lock, score, paintings, frame QA, motion in code, sound, delivery, archive) through stage gates, so no credit is spent before its gate passes. Keeps the production state file (production.yaml) and the credit ledger, prices the plan against the credits, and always names the one next action. Use this skill whenever the user wants to make, plan, budget, continue or check on a short film, painted film, animated story, music...

gallowforge/forge-frame-qa

FilmForge frame QA: inspects every painting at full size against the character sheets and the continuity ledger, measures colour rules, palette and exposure with tools, scores it on a nine-criterion rubric and decides: accept, fix in code (naming the module and the exact parameters), or repaint (with the root cause and the full corrected prompt). Use this skill whenever paintings, stills, keyframes, character sheets or book pages come back from an image model, when the user asks whether...

gallowforge/forge-motion

FilmForge motion: plans each shot's life in code instead of credits (painted holds brought alive with drifting fog, ash, snow, rain, embers, glints, light sweeps, firelight flicker, heat shimmer, shake, lightning, glass cracks, transitions, golden threads, handwritten words and titles), maps every effect to the painted-film-pipeline renderer's exact parameters, applies frame-QA code fixes, exports the edit timeline and renders the preview; decides when paid video is worth its credits. Use...

gallowforge/forge-painter

FilmForge painter: writes every shot's image prompt from the shot list, the character sheets and the style lock, on a fixed twelve-slot order with continuity anchors (handles, anchors, scale locks, props, states, forbidden-colour clauses); keeps the continuity ledger; lints every prompt before a credit is spent; paints in batches of four and hands each batch to frame QA. Use this skill whenever the user wants image prompts for a film's shots or a picture book's pages, storyboard frames,...

gallowforge/forge-style-lock

FilmForge style lock: fixes one image model and setting, one look sentence (or two when the drawing itself carries the story), the palette and colour rules, the line, brush and lens language, the character-sheet specs with scale bars, and the prompt grammar every shot must follow, so every painting in a film or book matches. Use this skill whenever the user starts the visual side of a film, music video or picture book, wants consistent characters or one consistent look across many images,...

Skills associés