Communitygithub.com

naterherkai/hyperframes-student-kit

Outil CLI HyperFrames — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. À utiliser pour initialiser un projet, linter ou valider des compositions, prévisualiser dans le studio, rendre en vidéo, transcrire de l'audio, générer du TTS, ou diagnostiquer l'environnement HyperFrames.

Qu'est-ce que hyperframes-student-kit ?

Le kit **HyperFrames CLI** est un outil en ligne de commande conçu pour les développeurs et créateurs de contenu vidéo qui travaillent avec le framework HyperFrames. Il permet d'initialiser un projet, de linter les compositions HTML, de prévisualiser en direct dans un studio web avec rechargement à chaud, de rendre des vidéos MP4/WebM avec des options de qualité et de format, de transcrire de l'audio (via Whisper) et de générer de la synthèse vocale (TTS). Le kit inclut également des commandes de diagnostic (`doctor`, `browser`, `info`, `upgrade`) pour vérifier l'environnement (Chrome, FFmpeg, Node.js) et résoudre les problèmes courants. Il supporte les agents IA et CI grâce au mode non-interactif et est compatible avec Cursor, Codex, et les environnements agentiques. L'utilisateur doit avoir Node.js >= 22 et FFmpeg installés.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/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

CLI HyperFrames

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

Workflow

  1. Scaffold — npx hyperframes init my-video
  2. Écrire — composer une composition HTML (voir la compétence hyperframes)
  3. Linter — npx hyperframes lint
  4. Prévisualiser — npx hyperframes preview
  5. Rendre — npx hyperframes render

Lintez avant de prévisualiser — détecte les data-composition-id manquants, les pistes qui se chevauchent, les timelines non enregistrées.

Scaffolding

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 de codage IA. Utilisez-le plutôt que de créer les fichiers manuellement.

Linting

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           # lisible par machine

Linte index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger impérativement), les avertissements (devraient être corrigés) et les informations (avec --verbose).

Prévisualisation

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

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

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 pour octet
OptionOptionsDéfautRemarques
--outputcheminrenders/nom_timestamp.mp4Chemin de sortie
--fps24, 30, 603060fps double le temps de rendu
--qualitydraft, standard, highstandarddraft pour itérer
--formatmp4, webmmp4WebM prend en charge la transparence
--workers1-8 ou autoautoChaque instance lance Chrome
--dockerflagdésactivéSortie reproductible
--gpuflagdésactivéEncodage accéléré GPU
--strictflagdésactivéÉchec sur erreurs de lint
--strict-allflagdésactivéÉchec sur erreurs ET avertissements

Conseils de qualité : draft pendant l'itération, standard pour la révision, 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 (TTS)

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 .     # mesurer la performance du rendu

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills associés