PORTÉE : ce skill CONSTRUIT du long-format 16:9. Ne le chargez pas lorsque vous montez un court.
Note permanente, 2026-08-15, et elle concerne le budget de contexte plutôt que l'exactitude. Ce fichier fait 500 lignes et chacune d'elles concerne une coupe long-format. Lors d'un A/B contrôlé sur la même source de 24 minutes, l'exécution dont l'arbre de compétences contenait ceci plus youtube-longform n'a pas produit de recherche de candidat-clip au Stade 2 ni de CAPTION.md, et a découpé son court à partir des 47 premières secondes de l'enregistrement. L'exécution sans eux a recherché la source entière et a livré les deux. Le guide n'est pas faux ; il y a beaucoup de contenu, il est sans rapport avec une verticale de 45 secondes, et il évince l'étape éditoriale qui n'avait pas de barrière de protection. scripts/verify_story.py est maintenant cette barrière.
Sa MÉTHODE est partagée et ce n'est pas une contradiction. short-composer (Étape 1) et graphics-only-short (Phase 4) citent tous deux la méthode de planification en un seul passage sur l'enregistrement entier ci-dessous, et ils la citent en deux paragraphes plutôt qu'en chargeant ce fichier. La colonne 9:16 dans le tableau de comparaison existe pour marquer ce que le chemin des courts fait différemment, pas pour être suivie ici. Clarifié le 2026-08-27, lorsque l'audit a interprété la note de portée comme contredisant le corps même du fichier.
Courts : skills/ultimate, qui possède l'emplacement 9:16, et skills/shorts-multiplatform.
Executive Animator
skills/broll-scout décide ce qui va à un horodatage. skills/stat-overlay construit un graphique. Ce skill est le passage entre eux : lire un enregistrement entier, proposer les 5-10 graphiques que cet enregistrement mérite réellement, prouver chacun d'eux par rapport à la transcription, puis les construire et les valider en une session de navigateur par lot au lieu de dix.
Hérite de skills/00-house-rules/SKILL.md et de chaque règle dans skills/stat-overlay/SKILL.md. Rien ici ne remplace le contrat de création. Cela ajoute uniquement la réception, la preuve et le traitement par lots.
0. Quelle cible — décidez d'abord, cela modifie les étapes 5, 6 et 7
Les sections 1 à 4 sont identiques pour les deux : réception, candidats, validation d'exactitude, le décompte. Les étapes 5 et suivantes ne le sont pas, et exécuter les instructions verticales sur une coupe 16:9 produit des graphismes que build_longform_composition.py ne peut pas utiliser du tout.
| 9:16 vertical | 16:9 long-format | |
|---|---|---|
| consommé par | build_composition.py | build_longform_composition.py |
| un graphique est | un .mov alpha composité sur le plateau | une scène déclarée dans composition.json |
| créé comme | une composition HyperFrames que vous écrivez | un kind + des champs ; le générateur écrit le HTML |
| vocabulaire | le registre de 373 blocs | les 14 kinds intégrés, un ensemble fermé |
| rendu | --format mov à la résolution de la composition, plus un jumeau mp4 | rien par graphique — un rendu à la fin |
| zone de sécurité | contenu au-dessus de y=1400, sans empiéter sur la bande de sous-titres | boîte de sécurité 16:9, sous-titres désactivés |
| plateforme de validation | --platform instagram_reels | --platform youtube_long |
| résolution finale | portrait-4k | landscape-4k |
| densité | un insert toutes les 8-12s (broll-scout) | 3-6 scènes + un stinger toutes les 20-40s |
| feuille de contact | un projet reel séparé dans overlays/ | probe_frames.py --plan --grid sur la comp |
Le chemin 16:9 n'a pas d'étape de création. Vous n'ouvrez pas le registre, vous n'écrivez pas de HTML, et vous ne rendez rien par candidat. Vous traduisez chaque candidat en l'un de ceux-ci :
title · chapter · statement · compare · lower_third · endcard — scènes, 8-15s, elles portent un argument que le spectateur lit.
converge · overload · steps · swap · countup · beats · surround · photo/clip — stingers, 2-4s, un geste chacun, COUPÉ SUR pas superposé.
skills/motion-language/SKILL.md possède ce vocabulaire et ses champs par kind. build_longform_composition.py se termine par unknown scene kind sur autre chose, donc un candidat qui ne correspond à aucun kind est supprimé — ce qui est généralement correct, car cela signifie que l'idée était décorative. Suivez ensuite skills/youtube-longform/SKILL.md à partir de son Stade 4.
Tout ce qui se trouve en dessous de cette ligne suppose le 9:16 sauf indication contraire.
1. Réception — pas de transcription, pas de plan
bash scripts/transcribe.sh VIDEO_UPLOAD/raw/<file>.mov drops/drop-NNN-slug/working
JSON au niveau du mot, pas un résumé. Chaque candidat est ancré à une plage de mots, donc une transcription au niveau du paragraphe rend tout le skill spéculatif. Si une transcription existe déjà dans working/, utilisez-la — ne retranscrivez pas.
Ensuite, regardez les images. Pas le fichier entier : python3 scripts/probe_frames.py est pour les compositions, donc pour les images source, extrayez des images avec ffmpeg toutes les ~10s et regardez-les. Vous vérifiez une chose : ce qui est déjà à l'écran. Un graphique qui duplique un enregistrement d'écran que l'intervenant montre déjà est un emplacement gaspillé et le niveau 1 vous le fera savoir.
2. Passage candidat — 5-10, et chacun porte une citation
Écrivez working/motion/ANIMATION-PLAN.json :
{
"source": "drops/drop-NNN-slug/working/transcript.json",
"duration_ms": 184000,
"candidates": [{
"id": "01-three-jobs",
"start_ms": 22400, "end_ms": 28100,
"quote": "a skill does three jobs, it names the task, it holds the steps, it carries the files",
"claim_on_screen": "3 jobs: name · steps · files",
"shape": "list",
"evidence": "spoken",
"block": "grid-card-assemble",
"mechanism": "three chips assemble out of scattered particles into a row",
"layout": "centre-stack",
"reason": "he enumerates three things and the viewer cannot hold three things by ear",
"status": "build"
}],
"rejected": [{
"quote": "it's been a wild year for agents",
"proposed": "timeline of model releases",
"reason_rejected": "he never names a date. the graphic would be inventing the content"
}]
}
Formes qui méritent un graphique, dans l'ordre où elles apparaissent généralement dans le discours : un nombre, une comparaison, une liste de trois éléments ou plus, un processus avec des étapes, un avant/après, une chronologie, une abstraction sans images de celle-ci. Tout le reste est le travail des images.
Enregistrez les rejets. Même raison que broll-scout : le journal des rejets empêche l'exécution suivante de reproposer la même chronologie décorative.
shape est vérifiée pour les répétitions au moment de la planification, avant toute construction. Si quatre candidats sont tous stat, l'enregistrement ne vous a pas donné quatre cartes stat — il vous a donné une idée que vous n'arrêtiez pas de recadrer. Fusionnez-les en un seul graphique qui contient les quatre nombres, ou supprimez-en trois. Révisez le plan ici ; le découvrir sur la feuille de contact signifie que vous avez construit quatre graphiques pour les jeter.
3. La validation d'exactitude — c'est tout l'intérêt
Un graphique est une affirmation rendue en 4K avec des polices de marque dessus, ce qui lui donne l'apparence d'être vérifié qu'il le soit ou non. Donc, par candidat :
quoteest textuellement issu de la transcription. Copiez-le, ne le retapez pas de mémoire.claim_on_screenpeut comprimer la citation. Il ne peut pas l'étendre. Supprimer des mots est du montage ; ajouter un nombre, une unité, un pourcentage, une date ou un nom propre que l'intervenant n'a jamais dit est de la falsification. Si le graphique a besoin d'un fait pour fonctionner et que l'intervenant ne l'a pas dit, le graphique ne fonctionne pas.evidenceest l'un despoken|cited|unconfirmed.spoken— il dit le nombre. La ligne source se lit comme lui.cited— il fait référence à quelque chose d'externe et vous avez résolu une véritable source primaire. Mettez la ligne source sur l'image. Chargez/verify-subagent-factual-claimsavant d'accepter un nombre qu'un sous-agent vous a remis.unconfirmed— l'image porte un⚠ unconfirmedvisible, ou le candidat est supprimé. Ce sont les deux seules issues. Ne le blanchissez jamais discrètement en une carte stat propre.
- N'animez pas une affirmation que vous avez dû stabiliser. Si faire correspondre la phrase au graphique a nécessité un arrondi, un recadrage ou « à peu près », supprimez le candidat. C'est le graphique qui n'est pas d'accord avec les images, et ce sont les images que l'humain a enregistrées.
4. Décompte — proposez 5-10, livrez ce que la durée permet
5-10 est la taille de l'ensemble des candidats, jamais le nombre qui atterrit dans une seule coupe. La règle de densité de broll-scout est contraignante pour 9:16 : environ un insert toutes les 8 à 12 secondes, et le niveau 1 gagne certains de ces emplacements directement. En 16:9, cette règle est beaucoup trop dense — prévoyez 3 à 6 scènes plus un stinger toutes les 20 à 40 secondes, ce qui représente près de 20 à 25 % de la durée avec un graphique.
| Durée | Graphiques qui peuvent réellement atterrir |
|---|---|
| Court de 30 à 60 s | 2-4 |
| Long-format de 3 à 5 min | 5-8 |
| 10 min+ | 8-10, puis arrêtez de proposer |
Ainsi, pour un seul court, attendez-vous à construire 5 à 10 candidats et à marquer la plupart d'entre eux status: "hold". C'est le résultat correct, pas un échec — un candidat en attente est un graphique fini qui attend la prochaine coupe du même enregistrement, ce qui est exactement ce que plan_calendar.py espace. Un plan de plans vide vaut mieux qu'un plan décoré.
Ne placez jamais un graphique dans les 3 premières secondes (l'accroche est le visage) ou en travers de la ligne de payoff (les beats émotionnels atterrissent sur les humains).
5. Construire — un projet, N sous-compositions
16:9 — ignorez complètement cette section. Il n'y a rien à créer. Écrivez les kinds et les champs dans
composition.jsonet allez auskills/youtube-longform/SKILL.mdStade 4. Tout ce qui suit jusqu'à la fin de la §7 décrit le modèle de composition vertical.
Créez selon skills/stat-overlay/SKILL.md — recherche dans le registre d'abord, vrais logos via /media-use, une timeline en pause, fromTo, 8-10 éléments dans trois couches, contenu au-dessus de y=1400, 5-7 secondes. Rien de cela ne change ici.
Deux compétences d'animation, et elles répondent à des questions différentes. Chargez les deux.
/hyperframes-animation— quel est le mouvement. Chargez-le avant de créer un candidat et composez 2-4 règles atomiques à partir de sonrules-index.md. Ne partez jamais d'une timeline vierge. Recourez à un plan directeur uniquement pour une chorégraphie véritablement multi-phases, et pour les formes que cette compétence produit le plus — une liste qui s'assemble, un nombre qui compte, un échange avant/après — ses 24 effets d'animation de texte nommés nomment généralement déjà ce que vous étiez sur le point de bricoler. Sur un ensemble de 5 à 10, c'est aussi ce qui maintient la cohérence de l'ensemble : choisissez le vocabulaire des règles une fois, au moment de la planification, et réutilisez-le. Dix graphiques qui inventent chacun leur propre entrée se lisent comme dix vidéos sans rapport./hyperframes-keyframes— comment l'interpolation est écrite. Chargez-le dès qu'un candidat nécessite un mouvement qu'aucun bloc du registre ne couvre : keyframes 2D/3D seek-safe, une timeline GSAP écrite à la main, une morphologie SVG ou un dessin de trait (getTotalLength()se révèle sur les icônes Lucide intégrées), un travail sur les chemins et les masques, FLIP, des traînées de texte, de la profondeur. C'est la compétence qui rend le mouvement écrit à la main seek-safe, ce qui est plus important ici qu'ailleurs dans le dépôt : le moteur de capture cherche de manière non linéaire, et une interpolation qui n'est correcte que jouée du début à la fin rendra un résultat erroné dans un reel qui comporte dix compositions.
Si un candidat peut être construit en composant uniquement des règles, n'ouvrez pas la compétence keyframes. Si ce n'est pas le cas, n'improvisez pas l'interpolation — ouvrez-la.
Variété : un système, dix phrases différentes
Ces deux échecs ne se ressemblent pas et tous deux tuent l'ensemble :
- Dix vidéos sans rapport. Différentes échelles de caractères, différentes progressions, différents poids de couleur. Cela se lit comme du stock, car le stock est le seul endroit où des graphiques sans rapport arrivent ensemble.
- La même carte dix fois. Une disposition, une entrée, seuls les mots changent. Cela se lit comme un modèle, et un spectateur le repère au troisième et arrête de lire le quatrième.
Donc fixez le système et variez l'exécution. Rien dans la colonne de gauche ne peut dériver à travers l'ensemble ; rien dans la colonne de droite ne peut se répéter.
| Constant pour tous les candidats | Distinct par candidat |
|---|---|
Couleur et caractère de brand/tokens.json | mechanism — le seul mouvement qui porte l'idée |
| L'échelle de caractères (taille titre / corps / étiquette) | Disposition : centre-stack, left-anchored, split, edge-anchored, full-bleed |
| La famille d'assouplissement et la signature temporelle | Direction d'entrée et axe sur lequel le mouvement se déplace |
| Dégagement de la bande de sous-titres, zone de sécurité, bande de 5 à 7 s | Bloc du registre, et les 2-4 règles composées depuis /hyperframes-animation |
| Le vocabulaire des règles — quelles règles sont en jeu | Lesquelles d'entre elles dirigent, et dans quel ordre |
| Traitement de la ligne source | Densité et rythme dans la bande de 5 à 7 s |
Appliquez-le mécaniquement, au moment de la planification :
mechanismest unique dans l'ensemble. Une phrase, décrivant le mouvement et non le contenu : « trois puces s'assemblent à partir de particules dispersées » est un mécanisme ; « montre les trois tâches » est une reformulation declaim_on_screen. Deux candidats dont les mécanismes se paraphrasent mutuellement sont un seul candidat — fusionnez ou supprimez. C'est le champ qui fait réellement le travail, car deux graphiques peuvent utiliser des blocs différents et se déplacer de manière identique.- Aucun bloc de registre deux fois, sauf s'il s'agit d'une famille
--batchdélibérée (voir la mise en garde ci-dessous). Avec 373 blocs dans le catalogue, utiliser le même deux fois signifie que la deuxième recherche a été plus paresseuse que la première. Cherchez par candidat, à partir de la propreshapedu candidat. layoutest unique dans l'ensemble, ou aussi proche que cinq emplacements le permettent. Si chaque graphique centre son contenu, le reel a une composition répétée dans différentes couleurs.- Variez le rythme. Selon
/hyperframes-creative, une seule scène veut 3+ progressions et une interpolation la plus lente ~3x la plus rapide — cela s'applique à travers l'ensemble aussi. Si chaque candidat se construit en 2s, tient en 3s et sort en 1s, ils sembleront identiques, peu importe leur apparence. - Alternez le registre. Un ensemble de cinq veut à peu près : un qui atterrit fort et vite, deux qui se construisent et se résolvent, un tierce inférieur calme qui bouge à peine, un qui mérite une vraie complexité. Cinq graphiques tous au maximum d'intensité se fondent en bruit.
La mise en garde --batch, qui est le piège pour lequel cette section existe. La section 5 dit que les candidats de même forme peuvent partager une composition et être rendus sous forme de lignes variables. C'est une réelle efficacité et cela fabrique également exactement l'échec ci-dessus : les frères et sœurs de lot sont identiques par construction. Donc, le lot est correct pour un ensemble qui est prévu...