Communitygithub.com

johnnyjclin/video-producer

Outil CLI HyperFrames — hyperframes init, lint, validate, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. À utiliser pour créer un projet, analyser ou valider des compositions, prévisualiser dans le studio, générer une vidéo, transcrire de l'audio, produire de la TTS ou diagnostiquer l'environnement HyperFrames.

Qu'est-ce que video-producer ?

Ce skill fournit un accès complet à l'outil CLI `hyperframes` (via `npx hyperframes`), qui est le cœur du flux de travail de production vidéo basé sur le navigateur d'HyperFrames. Il permet aux agents de créer automatiquement des projets, d'analyser statiquement le code de composition, de valider les compositions dans un navigateur réel (vérification du contraste WCAG, des contrats d'exécution et des ressources manquantes), de prévisualiser avec rechargement à chaud et de générer des vidéos MP4 ou WebM avec des options de qualité réglables. Il prend également en charge la transcription audio (via Whisper) et la synthèse vocale, ainsi que des diagnostics d'environnement via les commandes `doctor`, `browser`, `info` et `upgrade`. Il est conçu pour fonctionner avec Claude Code, Cursor et d'autres agents IA, et nécessite Node.js >= 22 et FFmpeg. Le skill met en évidence un flux de travail structuré : initialisation → écriture → analyse → validation → prévisualisation → rendu, la validation étant une étape essentielle, peu coûteuse, qui détecte les problèmes visibles uniquement dans le navigateur.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/johnnyjclin/video-producer/tree/HEAD/.claude/skills/hyperframes-cli

Demander à votre IA préférée

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

Documentation

HyperFrames CLI

Tout passe par npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.

Flux de travail

  1. Créer — npx hyperframes init my-video
  2. Écrire — composer le HTML de la composition (voir le skill hyperframes)
  3. Analyser — npx hyperframes lint (vérifications statiques)
  4. Valider — npx hyperframes validate (vérifications d'exécution basées navigateur + audit de contraste)
  5. Prévisualiser — npx hyperframes preview
  6. Rendre — npx hyperframes render

L'analyse détecte les problèmes statiques (data-composition-id manquant, pistes qui se chevauchent, timelines non enregistrées). La validation détecte les problèmes d'exécution/visuels en parcourant la composition en pause dans un navigateur réel (contraste, superpositions cassées, ressources manquantes). Exécutez les deux avant le rendu.

Validation

npx hyperframes validate                 # validation complète (statique + contraste + contrat)
npx hyperframes validate --no-contrast   # ignorer l'audit de contraste WCAG pour itérer rapidement
npx hyperframes validate --json          # sortie lisible par machine

La validation parcourt plusieurs horodatages de la composition en pause, capture la page en image, échantillonne les pixels derrière chaque élément de texte pour calculer les ratios de contraste WCAG, et vérifie les contrats d'exécution (enregistrement de window.__timelines, présence de class="clip", attributs data-* valides). Lancez-la avant chaque rendu — elle est peu coûteuse et détecte des problèmes que l'analyse ne voit pas.

Création

npx hyperframes init my-video                        # assistant interactif
npx hyperframes init my-video --example warm-grain   # choisir un exemple
npx hyperframes init my-video --video clip.mp4        # avec fichier vidéo
npx hyperframes init my-video --audio track.mp3       # avec fichier audio
npx hyperframes init my-video --non-interactive       # ignorer les invites (CI/agents)

Modèles : blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crée la structure de fichiers appropriée, copie les médias, transcrit l'audio avec Whisper et installe les compétences IA. Utilisez-la plutôt que de créer les fichiers à la main.

Analyse

npx hyperframes lint                  # répertoire courant
npx hyperframes lint ./my-project     # projet spécifique
npx hyperframes lint --verbose        # résultats au niveau info
npx hyperframes lint --json           # sortie lisible par machine

Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger), les avertissements (à corriger de préférence) et les informations (avec --verbose).

Prévisualisation

npx hyperframes preview                   # servir le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (par défaut 3002)

Recharge à chaud lors des modifications de fichiers. Ouvre automatiquement le studio dans votre navigateur.

Rendu

npx hyperframes render                                # MP4 standard
npx hyperframes render --output final.mp4             # sortie nommée
npx hyperframes render --quality draft                # itération rapide
npx hyperframes render --fps 60 --quality high        # livraison finale
npx hyperframes render --format webm                  # WebM transparent
npx hyperframes render --docker                       # sortie identique octet par octet
OptionOptionsDéfautNotes
--outputcheminrenders/nom_horodatage.mp4Chemin de sortie
--fps24, 30, 603060 ips double le temps de rendu
--qualitydraft, standard, highstandarddraft pour itérer
--formatmp4, webmmp4WebM prend en charge la transparence
--workers1-8 ou autoautoChacun lance Chrome
--dockerdrapeaudésactivéSortie reproductible
--gpudrapeaudésactivéEncodage accéléré par GPU
--strictdrapeaudésactivéÉchec en cas d'erreurs d'analyse
--strict-alldrapeaudésactivéÉchec en cas d'erreurs ET d'avertissements

Conseils de qualité : draft pour itérer, standard pour la revue, high pour la livraison finale.

Transcription

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # importer existant
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Synthèse vocale

npx hyperframes tts "Texte ici" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # afficher toutes les voix

Dépannage

npx hyperframes doctor       # vérifier l'environnement (Chrome, FFmpeg, Node, mémoire)
npx hyperframes browser      # gérer le Chrome intégré
npx hyperframes info         # version et détails de l'environnement
npx hyperframes upgrade      # vérifier les mises à jour

Exécutez doctor en premier si le rendu échoue. Problèmes courants : FFmpeg manquant, Chrome manquant, mémoire insuffisante.

Autres

npx hyperframes compositions   # lister les compositions du projet
npx hyperframes docs           # ouvrir la documentation
npx hyperframes benchmark .    # évaluer les performances de rendu

Skills associés