Communitygithub.com

shorts-director

Réalise une courte vidéo verticale sans visage, de l'idée au fichier master final, en s'améliorant à chaque exécution.

Qu'est-ce que shorts-director ?

Cette compétence agit comme un réalisateur pour la création de vidéos courtes verticales sans visage. Elle commence par générer trois prémisses divergentes, évaluées comme un acheteur, puis écrit l'épisode dans une salle d'écriture, le vocalise, le valide via un animatique, et décide battement par battement comment chaque moment est produit : dessiné en code avec Remotion, découpé à partir d'une image générée, un clip généré, ou une piste du moteur. Elle intègre des modes spécifiques (série, salle d'écriture, production, son, finition, comparaison, effets, amélioration) et ne se déclenche que sur des demandes de création de vidéos originales, jamais pour l'édition de fichiers existants ou d'expliqueurs purement codés. Elle est conçue pour les réplicateurs d'IA tels que Claude Code et s'appuie sur le dépôt 'gbax316/ai-shorts' pour l'infrastructure de rendu.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gbax316/shorts-director/tree/main/.claude/skills/shorts-director

Demander à votre IA préférée

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

Documentation

Shorts director

Un court métrage est jugé en deux secondes par quelqu'un qui ne lui doit rien. Tout dans cette compétence existe pour que la première coupe que vous remettiez soit celle que le propriétaire publierait : l'idée choisie parmi trois, les mots visibles à l'écran et audibles, aucune faute dans le cadre qu'il ne repère avant vous, et un mixage sonore qu'il peut écouter sur un téléphone dans un danfo. La qualité prime. Le coût est affiché avant chaque dépense, jamais utilisé comme plafond.

La compétence dirige ; les moteurs du dépôt font le travail. Les pistes du moteur (le kit Remotion, les outils d'images et de clips, les bibliothèques spécialisées, la caméra de collage) et les outils ajoutés depuis (mouth_sync, les cartes partagées, le chunker de légendes, les vérifications) sont des chemins de rendu que cette compétence choisit, battement par battement, plutôt qu'une seule piste par vidéo.

Avant tout : lire la configuration et la bible

L'identité vit dans la configuration, jamais dans la compétence. Lisez director.config.json à la racine du dépôt pour la marque, le filigrane, les personnes qu'un film peut nommer, le balisage des liens, les règles internes, les fournisseurs et leurs prix, et la cible de mastering. L'identité visuelle (couleurs, polices, logo) est dans remotion/src/brand.ts et remotion/src/fonts.ts. Si le court métrage appartient à une série, lisez sa bible dans ai-shorts/series/<series>/BIBLE.md avant d'écrire une ligne ; s'il s'agit d'une nouvelle chaîne ou d'un nouveau casting, le mode série en écrit d'abord une. Ensuite, lisez les dernières entrées de RUNS.md et LESSONS.md, car les défauts de la dernière exécution sont les moins chers à éviter dans celle-ci.

Les modes

ModeSon travailÀ lire
seriesla bible pour un casting récurrent ou un style de chaînemodes/series.md
writers-roomtrois prémisses divergentes évaluées comme l'acheteur, puis le scriptmodes/writers-room.md
producevoix, animatique, images, clips, bouches, compositionmodes/produce.md
soundfonds sonores, indications, mixage et masteringmodes/sound.md
finishle master, la copie pour téléphone, la vérification du texte, le pack de publicationmodes/finish.md
bakeofftester des modèles les uns contre les autres avant qu'un ne devienne la valeur par défautmodes/bakeoff.md
effects/effects <nom> : prévisualiser un effet, le placer sur un battement, ou en construire un nouveau dans la bibliothèquemodes/effects.md
improveaprès chaque court métrage : noter l'exécution, consigner les leçons, proposer des modifications de la compétencemodes/improve.md

Un nouveau court métrage les exécute dans l'ordre : series (uniquement si la bible manque), writers-room, produce, sound, finish, improve. Le propriétaire peut entrer à n'importe quel mode par son nom, et une demande qui relève clairement d'un seul mode (une reprise vocale, une correction de légende, un nouvel accroche) y va directement.

La voie rapide. Lorsque la bible de la série existe, le format est éprouvé et les moteurs sont connus, ne rien sauter mais tout raccourcir : un seul passage de prémisse au lieu d'un long, et des images réutilisées de la série là où elles conviennent. Les barrières et les vérifications restent exactement comme elles sont ; seuls les tours deviennent moins nombreux.

Les barrières qui tiennent à chaque exécution

Ce sont les endroits où l'œil du propriétaire se pose, dans l'ordre, et où le travail s'arrête jusqu'à ce qu'il réponde. Chacune est peu coûteuse à modifier à ce stade et coûteuse à modifier après.

  1. La prémisse. Trois, écrites et jugées comme l'acheteur, avec un choix et la raison. Rien n'est vocalisé avant qu'une soit choisie.
  2. La voix. Les lignes dans les mots du propriétaire là où il les a données. Pour tout ce qui est en pidgin ou un nom local, des auditions qu'il choisit à l'oreille (references/voice.md). Une prise choisie est placée exactement, jamais régénérée.
  3. L'animatique. Des images sur la timeline vocale réelle avec les gags dessinés en code, les légendes et les marqueurs rouges là où les clips iront. Aucun clip n'est généré avant que l'animatique ne soit approuvé.
  4. La dépense. Chaque étape de génération indique d'abord ses crédits ou dollars (references/stills-and-clips.md), et le total est rapporté après.
  5. La coupe. Le propriétaire regarde le montage brut avant le mastering, et le fichier final avant que quoi que ce soit ne soit publié.

Entre les barrières, vérifiez votre propre travail comme le décrit references/qa.md, afin que l'œil du propriétaire soit dépensé pour le goût et jamais pour un défaut qu'un scan aurait pu détecter.

Formats

Un format apporte sa propre grammaire (comment les battements s'enchaînent), son propre monde visuel et ses propres chemins de rendu par défaut. Ceux qui sont éprouvés jusqu'à présent ont chacun une référence :

  • references/formats/skit.md : un casting récurrent en dialogue (prouvé par Akpos et Segs, épisodes 1 et 2)
  • references/formats/documentary.md : un narrateur sur des scènes photoréalistes avec des figures sourcées (prouvé par le mini documentaire Qodeup 1)

Les formats du moteur restent également disponibles : les explaineurs dessinés en code via make-short et vidtsx-2d-generator, le collage via make-vox. Le réalisateur peut acheminer un court métrage entier vers l'un d'eux, ou emprunter un battement à l'un d'eux.

Quand le format demandé n'est pas encore éprouvé

Si le propriétaire demande un type de court métrage qu'aucun des formats ne couvre (une liste, un avant-après, un objet qui parle, un résumé d'actualités), dites-le clairement plutôt que de le forcer dans le format le plus proche ; une grammaire de sketch sur un résumé d'actualités produit quelque chose qui sonne faux d'une manière qu'il remarquera. Proposez deux voies. La première consiste à le configurer correctement : l'exécuter comme une exécution de validation, et une fois qu'il est expédié, écrire references/formats/<nom>.md à partir de ce que l'exécution a prouvé, via os-skillify, afin que la prochaine commence à partir d'une grammaire au lieu d'une supposition. La seconde consiste à le faire une fois avec le format le plus proche comme échafaudage, en nommant les lacunes, et ne rien sauvegarder. Si le même nouveau format se présente une deuxième fois, prenez la première voie ; un format qui continue d'être improvisé n'obtient jamais de grammaire, et la compétence réduit silencieusement ce que le propriétaire lui demande.

Comment ça s'améliore

Chaque court métrage se termine par le mode improve. Il note l'exécution par rapport aux résultats dans references/outcomes.md, la consigne dans RUNS.md, écrit ce qui a été appris dans LESSONS.md, et lorsqu'un défaut s'est produit deux fois ou qu'une technique a fait ses preuves, propose le changement à cette compétence en termes généraux, sous forme d'un diff que le propriétaire approuve. Git est le chemin du retour.

Références

  • references/outcomes.md : ce que la compétence doit produire, avec des chiffres, comment chacun est vérifié, et les boucles qui l'améliorent
  • references/render-routing.md : choisir, par battement, entre le code, un découpage, un clip généré et les pistes du moteur
  • references/voice.md : voix, casting, auditions, pidgin et noms, placement d'une prise choisie
  • references/stills-and-clips.md : génération d'images et de clips, prompts qui retiennent l'identité, re-tirages, prix
  • references/mouths.md : redessiner les bouches sur les clips générés avec mouth_sync, y compris les réglages par plan
  • references/facts.md : la barrière des faits pour tout ce qui est présenté comme vrai à l'écran
  • references/effects.md : les tâches qu'un battement peut avoir, l'effet qui sert chacune, et les règles de retenue qui empêchent un court métrage de devenir une vitrine de démonstration
  • references/qa.md : les vérifications entre les barrières, et ce que chacune a déjà détecté
  • references/formats/ : un fichier par format éprouvé

Compétences connexes

  • make-short, vidtsx-2d-generator : la piste d'expliqueur dessiné en code et ses règles de crash, utilisée comme chemin de rendu
  • make-vox : la piste de collage
  • make-ai-short : la piste générative, dont cette compétence reprend la discipline de clip
  • suggest-sfx : auditions de sons, appelées depuis le mode sound
  • os-writing (Personal OS) : accroches et légendes pour la publication, appelées depuis le mode finish
  • os-skillify (Personal OS) : écriture d'une nouvelle référence de format après son exécution de validation

Individual skills in this repo

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

gbax316/make-ai-short

Build a GENERATIVE-pixels vertical short (1080×1920, ~35-40s) end-to-end — a recurring locked character animated by a fal video model (Seedance 1.5 Pro default) under a philosophical/story VO, composited in Remotion with word-synced captions, SFX audition, seamless frame-0==last-frame loop. Use when the user wants to "make an AI video short", "make an ai short", "make a blue-man video", or any short where the pixels come from a VIDEO MODEL — not TSX animation (that is make-short) and not layered collage (that is make-vox). Defers model choice re-litigating to ai-shorts/IDEAS.md, TSX crash rules to vidtsx-2d-generator, SFX taste to suggest-sfx + brand §7. For a NEW short (writers' room, dialogue skits, documentaries, mixed render paths), start with shorts-director, which calls this track as an engine.

gbax316/vidtsx-2d-generator

Generate production-ready 2D TSX video files for VidTSX (Remotion-based) from a shot, scene, or video description. Use whenever the user wants to create or generate a VidTSX video, a 2D TSX shot or scene, an animated clip, title card, or rendered motion graphic — including when they describe a visual animation they want built, or say "make a shot", "build this scene", "generate the TSX", or "turn this into a video". Covers the mandatory file structure and composition config, dimension presets (horizontal/vertical/square), six style presets (minimalist, memphis, neo-brutalism, glassmorphism, neon, corporate), and the hard rules that keep renders from crashing, covering frame-based animation only (no useState/useEffect/setTimeout), strictly monotonic interpolate ranges, Easing.bezier not wrapper syntax, and the chroma-js and @remotion/paths import gotchas. Not for 3D/three.js compositions, general React work, or editing video files.

Skills associés