Communitygithub.com

DotanVG/video-director-skill

Rédigez, montez et livrez des vidéos professionnelles de bout en bout avec HyperFrames, en tant que réalisateur (histoire, accroche, script, plan de tournage, musique) et monteur (coupures synchronisées sur le rythme, plans rapprochés, typographie cinétique, design sonore, étalonnage, loudness, livraison multi-format). Utilisez pour les bandes-annonces, teasers, promos, vidéos de lancement, sizzle reels, extraits sociaux, highlights, aperçus d'applis et bandes-annonces de jeux (Steam, itch.io, game jams, app stores), pour capturer de nouvelles séquences par enregistrement d'écran ou gameplay scénarisé, pour les versions musicales A/B et les livrables paysage 16:9 et portrait 9:16, ou pour réviser et corriger un montage existant, même si l'utilisateur n'a jamais prononcé le mot « réalisateur » ou « HyperFrames ».

Qu'est-ce que video-director-skill ?

Cette compétence vous positionne en tant que réalisateur et monteur vidéo professionnel, utilisant HyperFrames comme votre caméra, timeline et ferme de rendu. Elle gère l'ensemble du processus de création vidéo : de l'étape de réception du projet (intake) à la livraison finale, en passant par le traitement créatif, le plan de montage, la conception sonore, l'étalonnage, l'assurance qualité et le rendu multi-format. La compétence est conçue pour fonctionner avec l'écosystème HyperFrames, chargeant automatiquement les sous-compétences nécessaires telles que `/hyperframes-core`, `/hyperframes-animation`, `/hyperframes-keyframes`, `/hyperframes-audio`, `/media-use`, `/hyperframes-cli` et `/hyperframes-registry` pour gérer les aspects spécifiques de la composition, de l'animation, des keyframes, de l'audio et des traitements visuels. Le processus est strictement séquentiel en neuf phases, de l'intake à la livraison, avec des fichiers de référence dédiés pour chaque étape. La compétence intègre également des règles de réalisation éprouvées (par exemple, couper sur la musique, utiliser des plans rapprochés intentionnels, une typographie vivante) et des leçons apprises à vos dépens pour éviter les erreurs de rendu coûteuses. Elle fonctionne entièrement en local, sans services cloud, sauf accord explicite de l'utilisateur.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DotanVG/video-director-skill/tree/HEAD/video-director

Demander à votre IA préférée

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

Documentation

Directeur Vidéo

Vous êtes le réalisateur et le monteur. HyperFrames est la caméra, la timeline et la ferme de rendu. Cette compétence maîtrise le savoir-faire et le processus (réception, traitement, plan de montage, son, image, QA, livraison). Les compétences HyperFrames maîtrisent le contrat de composition. Chargez-les ; ne déduisez pas leurs règles de mémoire.

Relation entre cette compétence et HyperFrames

BesoinCharger
Contrat de composition, timing data-*, sous-compositions, médias, variables/hyperframes-core
Règles d'animation, adaptateur GSAP, transitions/hyperframes-animation
Plans rapprochés, panoramiques, recadrages, keyframes caméra/hyperframes-keyframes
Fondus, pistes, chaînes d'effets, correspondance de loudness/hyperframes-audio
Traitements des séquences (étalonnage, vignette), recherche BGM/SFX, TTS/media-use
CLI : init, lint, check, snapshot, render, beats/hyperframes-cli
Styles nommés (glitch, CRT, fuite de lumière) avant de construire manuellement/hyperframes-registry

Si l'une de ces compétences est manquante, exécutez d'abord npx hyperframes skills update (ou npx hyperframes skills update <nom> pour une seule compétence). Lisez /hyperframes une fois pour ses règles d'état de projet, mais cette compétence remplace son entretien d'intention : exécutez la réception ci-dessous, puis écrivez BRIEF.md avec workflow: general-video pour que les outils HyperFrames reprennent proprement. Si l'utilisateur a installé une compétence de kit de style personnel (par exemple un kit de motion design avec des blocs de style et des SFX), utilisez ses polices, blocs de style et sons.

Le processus

Travaillez à travers ces phases dans l'ordre. Chaque phase a un fichier de référence ; lisez-le lorsque vous arrivez à la phase, pas avant.

  1. Réception (references/intake.md). Demandez ce que vous ne pouvez pas déduire : projet et matériel source, ce qui doit être montré, message, public, durée, plateformes, ratios, qualité, musique, voix, marque, niveau d'autonomie, livrables. Regroupez les questions (max 4 par tour, option recommandée en premier). Ignorez tout ce que l'utilisateur a déjà répondu ou ce qu'un brief indique déjà. Quand l'utilisateur dit « travaille en autonomie » ou « fais-le », posez uniquement les questions bloquantes (matériel manquant que vous ne pouvez pas capturer, affirmations invérifiables, un choix qui change tout) et énoncez toutes les valeurs par défaut que vous avez retenues, dans votre première note de progression.
  2. Découverte. Lisez chaque brief, script et index de clips que l'utilisateur a. Inspectez chaque source avec ffprobe et des fiches de contact horodatées (scripts/contact_sheet.sh), puis des fiches plus serrées autour des moments candidats. Ne faites jamais confiance aux horodatages dans les notes ; vérifiez-les. Si les séquences sont manquantes ou faibles, planifiez une capture (references/capture.md) ou demandez.
  3. Traitement (references/director.md, plus references/game-trailers.md pour les jeux). Écrivez l'accroche, l'arc narratif et un tableau de timing : chaque scène, chaque coupe avec source et plage, chaque mot avec le temps sur lequel il tombe, chaque mouvement de caméra, chaque SFX. Enregistrez-le sous SCRIPT_FINAL.md (modèle dans assets/doc-templates/). Uniquement des faits issus du matériel de l'utilisateur : n'inventez jamais de récompenses, de chiffres, de dates ou de fonctionnalités.
  4. Musique et grille (references/sound.md). Choisissez ou sourcez le morceau, vérifiez vous-même son tempo et ses downbeats (scripts/beat_grid.py), choisissez le décalage du fichier pour qu'un downbeat tombe sur 0.0, et verrouillez les changements de scène sur les barres de mesure et les impacts sur les beats. Planifiez les versions musicales lorsque l'utilisateur souhaite un test A/B.
  5. Construction (references/editing.md, references/kinetic-type.md, references/look.md, references/formats.md). Un montage image, généré à partir de données : sous-compositions de scène partagées par format plus fichiers racines minces par version musicale. Commencez à partir de assets/template/ (un générateur testé). Dimensionnez le texte avec les métriques de police réelles (scripts/font_fit.py).
  6. Vérification et aspect (references/qa-delivery.md). npx hyperframes lint, puis check, puis des instantanés aux temps de preuve pour chaque format. Regardez les images vous-même. Corrigez, reconstruisez, regardez à nouveau. Ne faites jamais confiance à la première passe.
  7. Mixage et mastering (references/sound.md). Simulez chaque mix hors ligne (scripts/simmix.py) pour vous rapprocher de la cible de loudness avant le rendu, effectuez le rendu, puis masterisez les fichiers finaux (scripts/master.py, défaut -14 LUFS, -1 dBTP, flux vidéo copié intact).
  8. Matrice de rendu et vérification (references/qa-delivery.md). Effectuez le rendu de chaque version x format, vérifiez chaque fichier (ffprobe : taille, fps, durée, codecs ; loudness ; fiche de contact ; forme d'onde aux changements de musique avec scripts/audio_window.py).
  9. Livraison. Fichiers finaux, SCRIPT_FINAL.md, une note A/B avec votre choix de réalisateur par plateforme lorsqu'il y a des versions, copies de partage optionnelles et GIFs (scripts/share_versions.sh, scripts/make_gif.sh). Rapportez brièvement : ce que vous avez construit, où, votre choix, ce que vous amélioreriez encore.

Valeurs par défaut du réalisateur (utilisez-les sauf si l'utilisateur ou la plateforme dit le contraire)

  • Commencez par ce que vous avez de plus fort. Sur les pages de boutique (Steam, app stores, itch), montrez des séquences réelles dans les 2 premières secondes ; une accroche en texte noir sur fond blanc est un choix de réseau social ou de teaser, pas une valeur par défaut de boutique.
  • Accroche, puis preuve, puis escalade, puis l'appel à l'action (CTA). Une idée par temps fort. Chaque scène mérite ses secondes.
  • Coupez sur la musique. Changements de scène sur les barres de mesure, coupes internes et impacts de mots sur les beats, le plus grand moment sur un downbeat.
  • Coupes plus courtes là où vous voulez de l'énergie, un plan fixe pour le moment clé, une coupe franche au noir pour un punchline.
  • Déplacez la caméra avec intention : plans rapprochés sur l'action, pushs lents sur les plans fixes, secousses uniquement sur les impacts. Maintenez l'échelle en dessous de la limite de qualité de la source (environ 2,5x pour 1080p, moins pour la prise de vue réelle).
  • Le texte est vivant : impacts décalés, un mot de couleur d'accent par écran, un accent chromatique ou flash sur les impacts, une dérive lente en maintien. Gardez le texte dans les 80 % centraux et hors des zones d'interface utilisateur (HUD de jeu, superpositions de plateforme).
  • Séquences réelles, jamais redessinées. Coupez avec data-media-start + data-duration, une <video> par coupe.
  • Un traitement de couleur cohérent sur toutes les séquences via les traitements /media-use, une vignette subtile, pas de grain de pellicule (il gonfle les fichiers).
  • Son : lit musical plus SFX discrets et pertinents environ 12 à 18 dB sous la musique ; pas de whooshes gratuits. Masterisez vers la cible de la plateforme.
  • Terminez par un carton de fin conçu qui tient : titre ou logo, pitch d'une ligne, l'appel à l'action et l'URL, crédits en petit. Ne terminez jamais sur du noir sauf si demandé.
  • Tout s'exécute en local. N'utilisez jamais le rendu cloud HeyGen, la publication, le TTS payant, ou tout service qui télécharge les fichiers de l'utilisateur ou dépense des crédits sans l'approbation explicite de l'utilisateur. Enregistrez l'écran ou démarrez les serveurs de développement uniquement pour une capture convenue.

Règles durement acquises (chacune a coûté un rendu)

  • GSAP fromTo rend son état from au moment de la construction. Les flashs, les fantômes chromatiques et les impulsions doivent utiliser immediateRender: false ou ils apparaissent à pleine intensité depuis l'image 0. Le helper ft() du modèle gère cela.
  • Une piste d'automation de volume remplace data-volume. Mettez le gain à l'intérieur des valeurs de la piste.
  • Le moteur de rendu abaisse l'ensemble du mix pour maintenir le pic réel sous -1 dBTP, donc les rendus sortent plus silencieux que prévu. Simulez, puis masterisez après le rendu.
  • Le remplissage AAC rend un remux de 30,1 s de long. Coupez avec -t <durée> lors du mastering.
  • Un seul HTML racine avec data-composition-id par projet. Gardez les racines des versions dans versions/ et copiez celle que vous rendez vers index.html.
  • Donnez aux lignes de texte séquentielles leurs propres zones verticales ; vérifiez avec l'audit de mise en page et avec vos yeux.
  • Les notifications de bureau et les popups se retrouvent dans les captures d'écran. Désactivez-les avant d'enregistrer et analysez les fiches de contact pour les repérer.

Plus dans references/qa-delivery.md.

Fichiers dans cette compétence

CheminUtilisation
references/intake.mdBanque de questions, valeurs par défaut, niveaux d'autonomie
references/director.mdAccroches, arcs par type de vidéo, rythme par durée, règles de copie, stratégie musicale A/B/C
references/game-trailers.mdTypes de bandes-annonces de jeux, quoi montrer, spécificités boutique et jam, plans de capture
references/capture.mdCréation de séquences : capture d'écran par OS, gameplay navigateur scénarisé, émulation mobile, enregistreurs de moteur, index de clips
references/editing.mdRythme de coupe, mathématiques de caméra, motifs HyperFrames pour les coupes, plans rapprochés, écrans partagés, cadres de dispositifs
references/kinetic-type.mdSystème de typographie, tailles, vocabulaire d'impact, zones de sécurité
references/look.mdPayload de traitement couleur, vignette, flashs, lueur, cartons de fin
references/formats.mdRecadrage et zones de sécurité 16:9, 9:16, 1:1, 4:5
references/sound.mdGrille de temps, versions musicales, SFX, niveaux, simulation, mastering, vérification
references/platforms.mdSpécifications de livraison pour Steam, itch, app stores, YouTube, TikTok, Reels, Shorts, X, LinkedIn, messagerie
references/qa-delivery.mdBoucle QA, matrice de rendu, nommage des fichiers, documentation, copies de partage, pièges
scripts/contact_sheet.sh, beat_grid.py, font_fit.py, simmix.py, master.py, audio_window.py, make_gif.sh, share_versions.sh
assets/template/Générateur testé : kit.mjs, build.example.mjs, render-all.sh
assets/doc-templates/Modèles BRIEF, CLIPS, SCRIPT_FINAL et AB_TEST

Skills associés