Communitygithub.com

notivn/AIEV

Créeur de vidéos de bout en bout, conçu pour les débutants, pour HyperFrames. À utiliser lorsque l'utilisateur dit « fais une vidéo », « crée une vidéo », « nouvelle vidéo », « construis une vidéo », « vidéo de zéro », « je veux faire une vidéo », « aide-moi à créer une vidéo », ou lorsque quelqu'un qui n'a jamais utilisé HyperFrames arrive avec un concept, un script ou une idée grossière et veut un MP4 final. Interviewe l'utilisateur en un seul passage, puis construit la vidéo complète avec des étapes obligatoires de prévisualisation et de vérification visuelle.

Qu'est-ce que AIEV ?

Cette compétence agit comme un assistant complet pour la création vidéo de bout en bout, spécialement conçue pour les utilisateurs novices de la plateforme HyperFrames. Elle guide l'utilisateur à travers huit étapes séquentielles, divisées en deux phases : l'interview (collecte des intentions, script, style) et la construction (scaffold, storyboard, compositions, rendu final). Son objectif principal est de transformer une idée, un concept ou un script brut en un fichier MP4 final, en garantissant une qualité optimale via des étapes de prévisualisation et de vérification visuelle obligatoires. La compétence prend en charge l'interview de l'utilisateur dans une seule session, la synthèse des informations dans un brief, la création de storyboards, le développement de compositions HTML/GSAP, le linting, la prévisualisation Studio, le rendu de brouillon, la vérification visuelle (extraction et analyse d'images) et le rendu final. Elle s'intègre avec HyperFrames et d'autres compétences (comme `/short-form-video`) pour des formats spécifiques comme les vidéos verticales 9:16 avec visage. La compétence interdit l'utilisation de valeurs aléatoires (`Math.random`, `Date.now`) et insiste sur des vérifications manuelles de chaque image avant la livraison du produit final.

Compatible avec~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/notivn/AIEV/tree/HEAD/.claude/skills/make-a-video

Demander à votre IA préférée

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

Documentation

Créer une vidéo - La compétence Du Débutant au MP4 Terminé

Deux phases, huit étapes séquentielles. Chaque étape produit un artéfact concret consommé par l'étape suivante. Ne sautez pas les étapes.

Quand utiliser cette compétence - et quand passer la main

Utilisez cette compétence quand :

  • L'utilisateur est novice avec HyperFrames et part d'un concept, d'un script ou d'un plan
  • Il souhaite un parcours complet, pas des références sur le framework
  • Il n'a pas encore choisi de format

Passez la main quand :

  • L'utilisateur colle une URL et veut une vidéo de ce site → invoquez /website-to-hyperframes
  • L'utilisateur veut explicitement une vidéo verticale 9:16 avec visage et superpositions de scènes → exécutez les étapes 1 à 4 ici, puis invoquez /short-form-video à partir de l'étape 5
  • L'utilisateur demande les règles du framework, pas une vidéo → invoquez /hyperframes

Note de routage (pipeline AI Edit Video) : lorsque cette compétence est exécutée à partir d'un brief de projet, les sections STYLE DESIGN et PHONG CÁCH DỰNG (style vidéo) de l'invite d'édition remplacent les valeurs par défaut de l'interview ci-dessous - ne posez pas à nouveau les questions de style auxquelles le brief répond déjà.

Les deux phases

  • Phase 1 - INTERVIEW (étapes 1–4) : un seul passage conversationnel pour rassembler tout avant de toucher au code. Intention, format, script, voix, style, assets, rythme. Synthétisez en un BRIEF.md et attendez une approbation explicite.
  • Phase 2 - CONSTRUCTION (étapes 5–8) : scaffold → storyboard → compositions → lint → prévisualisation Studio → rendu brouillon → vérification visuelle → prévisualisation MP4 → rendu final.

Étape 1 · Intention et format

Posez une question à la fois via AskUserQuestion, avec des choix multiples si possible.

  1. À quoi sert cette vidéo ? (promo · publicité sociale · teaser de lancement · démo produit · tutoriel · explicatif · carte d'intro/outro · autre)
  2. Qui est le public ? (libre)
  3. Durée cible ? (10–20s court · 20–45s promo · 45–90s explicatif · 1.5–3 min leçon · personnalisé)
  4. Format d'image ? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
  5. Images par seconde ? (30 par défaut · 60 pour UI nette · 24 cinématographique)
  6. Plateforme / contraintes de livraison ? (taille de fichier · date limite · lieu de lecture)

Étape : les six éléments sont capturés. Si la réponse est 9:16 + visage, prévoyez de passer à /short-form-video à l'étape 5.

Banque de questions complète : Read: references/interview-questions.md


Étape 2 · Script et voix

  1. Source du script ? (coller · plan → je rédige · j'enregistre · TTS à partir du texte · pas de narration)
  2. Si TTS : préférence vocale. Proposez des choix à partir de npx hyperframes tts --help. Capturez également le rythme. hyperframes tts (Kokoro) est uniquement en anglais - la narration vietnamienne passe par le /api/tts du système (Gemini TTS ou VieNeu).
  3. Si visage : chemin d'enregistrement · placement plein écran ou dans un coin · besoin de transcription ? (npx hyperframes transcribe <fichier> --model small.en --json - anglais uniquement ; pour le vietnamien, utilisez faster-whisper selon la compétence noti-tiktok-vn)
  4. Sous-titres ? (désactivé · hype · corporate · karaoké mot-à-mot · minimal)

Étape : script capturé (ou rédigé), plan audio capturé, plan de sous-titres capturé.


Étape 3 · Recueil du style

Avant de demander quoi que ce soit à l'utilisateur, inventorier les assets existants. Vérifiez <racine-espace-de-travail>/assets/ et tout dossier assets/ du projet. Ne demandez pas ce qui est déjà là.

Puis demandez progressivement - ils n'ont pas besoin de réponses à tout :

  1. Guide de style ou document de marque ? (coller/chemin · non)
  2. Palette de couleurs ? (codes hex · aucun - utiliser les valeurs par défaut de MOTION_PHILOSOPHY)
  3. Polices ? (nom(s) Google Fonts · chemins de fichiers · aucun - utiliser les valeurs par défaut Inter + JetBrains Mono)
  4. Fichier logo ? (chemin · aucun). Si une marque est nommée mais aucun fichier n'est donné : cherchez dans assets/brand-logos/, ou récupérez-le avec POST /api/brand-logos {"name":"..."} - un mot-symbole textuel est autorisé UNIQUEMENT après un 404 BRAND_LOGO_NOT_FOUND. Ne dessinez ni ne générez jamais de logo.
  5. Vidéos de référence pour l'ambiance ? (URLs/chemins · aucun)
  6. Autres assets ? (captures d'écran · photos de produits · rushes · musique - listez les chemins)
  7. Esthétique MOTION_PHILOSOPHY (toile noire · texte chromé · grille de perspective · transitions whip) ou une autre sensation ?
  8. Rythme ? (kinétique 1–2s · équilibré 2–3s · relaxé 3–5s)
  9. Musique ? (aucune · nappe ambiante 0.15 · fond musical 0.4 · complet 0.8 - chemin du fichier s'ils en ont un)
  10. Texte d'outro / appel à l'action ?

N'imposez jamais une marque à l'utilisateur. Revenez aux valeurs par défaut de MOTION_PHILOSOPHY uniquement lorsqu'il refuse explicitement de fournir un style.

Flux de style complet + valeurs par défaut de MOTION_PHILOSOPHY : Read: references/style-intake.md


Étape 4 · Synthèse du brief (ÉTAPE VERROU avant la construction)

  1. Lisez MOTION_PHILOSOPHY.md s'il existe dans la racine de l'espace de travail - obligatoire s'il est présent. S'il manque, procédez avec les valeurs par défaut dans references/style-intake.md et notez l'absence dans le brief.
  2. Demandez où se trouvent les projets si ce n'est pas évident :
    • Si video-projects/ existe → utilisez video-projects/<slug>/
    • Sinon → demandez à l'utilisateur
  3. Écrivez <dossier-projet>/BRIEF.md :
    • slug · intention · public · dimensions · fps · durée
    • script (complet ou plan)
    • choix de voix · plan de sous-titres · plan de visage
    • profil de style : palette (hex), polices, chemin du logo, vidéos de référence
    • rythme
    • inventaire des assets avec chemins
    • texte d'outro / CTA
  4. Montrez le brief. ATTENDEZ une approbation explicite. Ne passez pas à l'étape 5 sans un « oui, construis-le » clair.

Étape 5 · Scaffold et storyboard

Vérification de passage d'abord

Si le brief décrit une vidéo verticale 9:16 avec visage et superpositions de scènes, invoquez /short-form-video MAINTENANT et transmettez le brief. Son scaffold en 4 couches est spécialement conçu pour ce format.

Sinon, continuez :

Scaffold

  1. mkdir <dossier-projet>
  2. Si un projet frère avec un format similaire existe, proposez de copier ses hyperframes.json + meta.json comme modèle. Sinon, depuis l'intérieur du dossier : npx hyperframes init
  3. Modifiez meta.json avec le slug, les dimensions, le fps de l'utilisateur.
  4. Copiez les assets fournis dans <dossier-projet>/assets/.
  5. Créez <dossier-projet>/assets/style-profile.md à partir de l'étape 3 - source unique de vérité pour la palette/ polices/logo.

Storyboard

Générez <dossier-projet>/STORYBOARD.md en utilisant le modèle dans references/storyboard-template.md. Chaque battement obtient :

Battement N - TITRE (début–fin, durée) - Concept en une phrase
Éléments visuels : [chaque élément, taille, animation, timing]
Langage de mouvement : [type de mouvement]
Easings utilisés : [3–4 easings GSAP distincts]
Sortie : [transition vers le battement suivant]
Audio : [ligne VO / SFX / couche musicale]

En haut du fichier : un tableau de timing avec scène · début · durée · fichier de composition.

Proposez une structure en trois actes :

  • Acte 1 (accroche) ≈ 20% de la durée
  • Acte 2 (corps) ≈ 55%
  • Acte 3 (conclusion + outro avec pause de 4–6 secondes) ≈ 25%

(MOTION_PHILOSOPHY §0 Loi 9, §1.)

Mappez les intentions utilisateur → blocs du catalogue : Read: references/catalog-intent-map.md

Étape : montrez le storyboard + le tableau de timing. Itérez jusqu'à ce que l'utilisateur approuve.


Étape 6 · Construire les compositions

Invoquez /hyperframes pour les règles du framework. Cette compétence possède le scaffold et la discipline ; /hyperframes applique les règles.

Scaffold pour chaque sous-composition

<div data-composition-id="nom-scène" data-start="..." data-duration="...">
  <style>[data-composition-id="nom-scène"] { /* limité */ }</style>
  <!-- DOM -->
  <script>
    (function(){
      const SLOT_DURATION = ...;
      const tl = gsap.timeline({ paused: true });
      // ... interpolations ...
      tl.to({}, { duration: SLOT_DURATION }, 0);   // ancrage - MOTION_PHILOSOPHY Loi 11
      window.__timelines["nom-scène"] = tl;
    })();
  </script>
</div>

Modèle complet + modèle de sous-titres + modèle d'arrière-plan ambiant : Read: references/composition-scaffold.md

Règles de construction

  • Arrière-plan ambiant sur data-track-index="0" pour toute la durée de la composition.
  • Ouvertures typographiques cinétiques : décalage par mot de 0.06–0.10s.
  • Sous-titres en tant que frères de niveau corps de la composition racine dans index.html, chacun avec data-track-index ≥ 20. Jamais à l'intérieur des timelines de scène (MOTION_PHILOSOPHY §3.13).
  • Blocs du catalogue installés via npx hyperframes add <nom>. Immédiatement limitez le CSS du bloc à [data-composition-id="..."] - les blocs du catalogue sont livrés avec des règles html, body { ... } qui se répandent dans le document parent lorsqu'ils sont chargés comme sous-compositions.
  • Vertical + visage : enveloppez le visage natif 1920×1080 dans une transformation (translate + scale) pour le mode moitié inférieure ou plein écran. (Si vous arrivez ici au lieu de /short-form-video, envisagez sérieusement le passage.)
  • Appliquez UNIQUEMENT ce que l'utilisateur a fourni. Leur palette, leurs polices, leur logo. N'injectez rien d'autre. S'ils ont choisi les valeurs par défaut de MOTION_PHILOSOPHY, tirez la palette + la paire de polices de references/style-intake.md.

Déterminisme

Pas de Math.random(), pas de Date.now(), pas de fetch() au moment du rendu. Utilisez des PRNG ensemencés ou des hachages sinusoïdaux harmoniques (MOTION_PHILOSOPHY §3.10).


Étape 7 · Lint → Prévisualisation Studio (PRÉVISUALISATION ÉTAPE 1 - OBLIGATOIRE)

  1. npx hyperframes lint - corrigez toutes les erreurs, triez les avertissements.
  2. npx hyperframes preview en arrière-plan.
  3. Attendez "Studio running" sur http://localhost:3002.
  4. Donnez à l'utilisateur l'URL plus les URLs individuelles des compositions (http://localhost:3002/?comp=<id>). Si le projet a des blocs shader WebGL, commencez par les URLs individuelles - le repli logiciel WebGL peut bloquer la composition principale.
  5. ATTENDEZ un « ça a l'air bon, fais un rendu brouillon » explicite avant de continuer. Le silence n'est pas une approbation.

Le rechargement à chaud est activé - les modifications apparaissent en direct.


Étape 8 · Rendu brouillon → Vérification visuelle → Prévisualisation MP4 → Final

Rendu brouillon

npx hyperframes render --quality draft --output renders/<slug>-draft.mp4

Vérification visuelle (OBLIGATOIRE avant la livraison)

Réussir le lint ne signifie pas que le design fonctionne. Extrayez les images et regardez-les.

  1. mkdir -p renders/frames
  2. Pour chaque moment clé de battement ET chaque transition :
    ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png
    
  3. Appelez l'outil Read sur chaque PNG. L'outil Read charge l'image dans le contexte - ne vous contentez pas de lister les noms de fichiers.
  4. Confirmez par image : pas de visages recadrés, mode visage correct par scène, texte lisible et dans la palette, pas de débordement, transitions atterrissant sur les mots prévus, pas d'images vides.
  5. Si quelque chose ne va pas : corrigez → re-rendu → re-vérifiez. Ne livrez jamais un brouillon défectueux.

Prévisualisation MP4 (PRÉVISUALISATION ÉTAPE 2 - OBLIGATOIRE)

npx serve renders -p 8080 -n

N'utilisez PAS le http.server de Python - il ne prend pas en charge les requêtes HTTP Range, donc le défilement est cassé.

Donnez à l'utilisateur http://localhost:8080/<slug>-draft.mp4. ATTENDEZ un feu vert explicite sur la lecture et la synchronisation audio.

Rendu final

npx hyperframes render --quality standard --output renders/<slug>-final.mp4

Dans le pipeline AI Edit Video, ce n'est PAS la fin : continuez avec la compétence video-pipeline (QC → assemblez le final via la file d'attente de rendu → outputs/<id>-v<N>.mp4 → mettez à jour meta.json → vignette/publication). Utilisation autonome en dehors du pipeline : rapportez le chemin de sortie. Terminé.

Liste de contrôle complète avant vol et avant livraison : Read: references/build-checklist.md


Non-négociables (structuraux - ne les assouplissez pas)

  • NE SAUTEZ PAS la PRÉVISUALISATION ÉTAPE 1 (Studio) ou la PRÉVISUALISATION ÉTAPE 2 (MP4 rendu). Deux étapes par construction, toujours.
  • NE DITES PAS qu'un rendu est terminé avant que les images aient été extraites ET lues via l'outil Read.
  • NE CONSTRUISEZ PAS ailleurs que dans un dossier de projet dédié. Ne mettez jamais index.html à la racine de l'espace de travail.
  • NE DEMANDEZ PAS les assets à l'utilisateur avant d'avoir inventorier son espace de travail.
  • NE SAUTEZ PAS l'interpolation d'ancrage tl.to({}, { duration: SLOT_DURATION }, 0) à la fin de chaque timeline de sous-composition. MOTION_PHILOSOPHY Loi 11.
  • N'UTILISEZ PAS Math.random() / Date.now() dans la logique de rendu. Uniquement des hachages ensemencés.
  • N'AJOUTEZ PAS class="clip" aux balises <video>. Cela les casse.
  • N'IMPOSEZ PAS une marque à l'utilisateur. Demandez d'abord ; revenez aux valeurs par défaut de MOTION_PHILOSOPHY uniquement lorsqu'il refuse explicitement.

Références

  • references/interview-questions.md - banque de questions complète par étape
  • references/style-intake.md - interview de style + valeurs par défaut de MOTION_PHILOSOPHY
  • references/catalog-intent-map.md - « l'utilisateur dit X → installez Y »
  • references/storyboard-template.md - modèle battement par battement + exemple travaillé
  • references/composition-scaffold.md - styles limités + modèle GSAP IIFE
  • references/build-checklist.md - étapes avant vol et avant livraison

Externes (niveau espace de travail) :

  • MOTION_PHILOSOPHY.md - la seule référence externe que cette compétence suppose exister. Base de référence esthétique. Le repli se trouve dans references/style-intake.md si le fichier est manquant.

Compétences associées

  • /hyperframes - règles du framework, invoquez à l'étape 6
  • /hyperframes-cli - init · lint · preview · render · transcribe · tts
  • /hyperframes-registry - installation des blocs du catalogue
  • /gsap - référence d'animation GSAP
  • /short-form-video - passez la main à l'étape 5 pour le format 9:16 avec visage
  • /website-to-hyperframes - passez la main à l'étape 1 si l'entrée de départ est une URL

Skills associés