Communitygithub.com

natesherkai/hyperframes-student-kit

Planifier, écrire, chronométrer, styliser et valider les beats de graphiques animés pour les vidéos HyperFrames longues avec prise de parole. Utilisez cette compétence lorsque Codex doit ajouter ou améliorer des beats visuels, des tiers inférieurs en verre dépoli, des prises de vue pleine écran en papier froissé, des callouts synchronisés avec la transcription, la couverture du rythme, les graphiques de rétention YouTube ou les superpositions prêtes pour le rendu dans un projet vidéo HyperFrames existant.

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

Cette compétence transforme une vidéo de prise de parole accompagnée d'une transcription en un ensemble rythmé de graphiques animés qui soutiennent la narration sans obstruer inutilement l'orateur. Elle est conçue pour les projets HyperFrames et s'exécute dans Codex, Claude Code, ou tout autre agent compatible avec le format de compétence. La compétence guide l'agent à travers une analyse systématique : inspection des instructions du projet, cartographie de la couverture des beats à partir du planning maître, extraction des segments de transcription, et décision du type de beat approprié (prise pleine écran en papier froissé pour les thèses majeures ou les statistiques, ou carte en verre dépoli en tiers inférieur pour les explications et les transitions). Elle applique des heuristiques de rythme pour maintenir l'engagement (pas plus de 20 à 45 secondes sans beat visuel selon la section), des règles de timing précises synchronisées avec la parole, et une écriture de contenu orientée lecture rapide (phrases nominales courtes, un modèle mental par carte). La compétence implémente également des règles de style visuel strictes (typographie professionnelle, texte noir sur fond clair, bleu d'accentuation pour les chiffres importants, placement évitant le visage) et des règles techniques HyperFrames (attributs `data-start`/`data-duration`, timeline GSAP, linting avec `npx hyperframes lint`). Enfin, elle inclut une validation automatique (linting, rapport des modifications) et préserve les choix esthétiques de l'utilisateur.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/hyperframes-video-beats

Demander à votre IA préférée

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

Documentation

HyperFrames Video Beats

Utilisez cette compétence pour transformer une vidéo de prise de parole et sa transcription en un ensemble rythmé de graphiques animés qui soutiennent la narration sans masquer inutilement l'orateur.

Objectif principal

Gardez le spectateur orienté et engagé. Chaque beat doit répondre à l'une de ces questions :

  • Que doit retenir le spectateur ?
  • Quel concept a besoin d'une structure visuelle ?
  • Quelle statistique, quel contraste ou quel point pivot mérite d'être mis en avant ?
  • Où le rythme devient-il suffisamment calme pour que le spectateur puisse décrocher ?

N'ajoutez pas de graphiques simplement parce qu'un vide existe. Ajoutez des graphiques parce que la narration présente un sujet, une transition, un point de preuve ou un modèle mental qui bénéficie d'un support visuel.

Première passe

  1. Lisez les instructions du projet (AGENTS.md, les documentations locales de compétence et les notes spécifiques au projet).
  2. Inspectez la composition racine, le planning des beats actuel, le CSS partagé et la transcription.
  3. Construisez une carte de couverture à partir des entrées data-start / data-duration racines ou du tableau maître SHOW.
  4. Extrayez les segments de transcription pour toute région demandée et les éventuels vides non couverts.
  5. Identifiez les plages de sujets par la narration, pas par des horodatages arbitraires.
  6. Décidez si chaque sujet nécessite un beat papier pleine écran, une carte en verre en tiers inférieur ou aucun nouveau beat.

Utilisez des commandes locales rapides. Préférez rg, Select-String et de petits scripts Node/PowerShell pour la transcription.

Décision du type de beat

Utiliser le papier froissé pleine écran

Utilisez une prise de vue papier lorsque la narration atteint une thèse majeure, une liste, un marqueur de section, une citation ou une statistique qui doit brièvement occuper tout le cadre.

Bons usages :

  • Retour d'accroche ou aperçu "dans cette vidéo"
  • Transition de section majeure
  • Statistique ou résultat d'étude important
  • Ligne de thèse mémorable
  • Citation ou mantra court(e)
  • Contraste qui demande au public de s'arrêter et de regarder

Règles :

  • Restez court, généralement 4 à 12 secondes.
  • Utilisez un texte noir espacé.
  • Réservez la couleur d'accentuation aux vrais chiffres statistiques ou à un mot extrêmement important.
  • Ne couvrez pas de longues explications avec des prises de vue papier.
  • Ne rendez pas le texte plein écran ludique, énorme ou trop gras par défaut.

Utiliser le tiers inférieur en verre dépoli

Utilisez un tiers inférieur en verre lorsque l'orateur doit rester visible et que le graphique doit soutenir l'idée en cours.

Bons usages :

  • Échafaudages d'explication
  • Étiquettes de sujets
  • Modèles mentaux de type équation
  • Petites listes
  • Traductions "ce que cela signifie"
  • Remplissages de rythme pendant de longues phases de prise de parole
  • Cartes de suivi après un beat plein écran ou écran partagé raccourci

Règles :

  • Gardez les tiers inférieurs dans le tiers inférieur ou la moitié inférieure.
  • Évitez de couvrir le visage.
  • Utilisez un texte concis : un titre plus une sous-ligne facultative, ou une liste de 2 à 4 éléments.
  • Préférez une carte par plage de sujet plutôt que de nombreux flashs minuscules.
  • Conservez le style de carte en verre existant, sauf si l'utilisateur demande un changement de design.

Heuristiques de rythme

Pour les vidéos YouTube longues avec prise de parole :

  • Début de vidéo : évitez plus de 20 à 30 secondes sans beat visuel.
  • Corps principal : évitez plus de 30 à 45 secondes sans beat.
  • Sections d'explication dense : utilisez des tiers inférieurs environ toutes les plages de sujets, pas toutes les phrases.
  • Les grandes prises de vue papier doivent être une ponctuation occasionnelle, pas la norme.
  • Si un beat existant a été manuellement raccourci parce qu'il semblait trop long, respectez ce choix et remplissez après avec une nouvelle carte plus courte.

Lorsque vous analysez un planning, signalez les vrais vides à partir du planning de visibilité, pas seulement de l'ordre du DOM. Si la timeline racine utilise un tableau SHOW, c'est généralement la plage visible faisant autorité.

Méthode de chronométrage

Chronométrez chaque beat en fonction du sujet de la transcription :

  1. Trouvez le premier mot ou la première phrase où le sujet commence.
  2. Commencez le beat 0,2 à 0,6 seconde avant ce point d'ancrage si possible.
  3. Gardez le beat visible jusqu'à ce que le sujet se termine ou se transmette naturellement.
  4. Si le beat suivant commence immédiatement, effacez 0,1 à 0,5 seconde avant, sauf si la transition est intentionnelle.
  5. Synchronisez les entrées des sous-éléments avec les phrases prononcées.

Évitez ce mode de défaillance :

  • La carte apparaît sur le bon sujet mais ne dure que 5 à 8 secondes alors que l'orateur continue de discuter du sujet pendant 20 à 40 secondes.

Préférez :

  • Une carte vit sur tout le sujet, avec une sous-ligne ou un élément de liste qui se construit à mi-parcours si la narration évolue.

Rédaction du contenu

Écrivez pour une compréhension en un coup d'œil. Le spectateur doit comprendre la carte en moins d'une seconde.

Utilisez :

  • Des syntagmes nominaux courts
  • Des étiquettes directes
  • Un modèle mental par carte
  • Des chiffres uniquement lorsqu'ils sont significatifs
  • Des verbes lorsqu'ils clarifient l'action

Évitez :

  • Répéter toute la voix off
  • Les phrases longues
  • Le langage vague et promotionnel
  • Trop de mots en surbrillance
  • Expliquer comment utiliser la vidéo à l'intérieur du graphique

Bons modèles :

Le goulot d'étranglement
Pas assez d'IA dans les flux de travail réels.
Le problème est l'adoption, pas le talent brut.
Le pont
Compétences + Flux de travail = 40 h économisées
Dans cette vidéo
-> L'étude
-> Les statistiques
-> Les chemins possibles
-> Ce qui compte vraiment

Règles de style visuel

Suivez d'abord le système de design local. Pour cette famille de projets, utilisez :

  • Une typographie professionnelle sobre.
  • Un texte principal noir sur les beats papier.
  • Un bleu d'accentuation uniquement pour les grands chiffres statistiques ou les mots de pouvoir rares.
  • Des cartes en verre avec le style givré foncé existant.
  • Des cartes en tiers inférieur qui ne couvrent pas le visage de l'orateur.

Pour les beats papier :

  • Utilisez le noir pour les accroches, les étiquettes, les flèches, les sources, les citations et le texte de soutien.
  • Gardez un poids de police sobre.
  • Évitez les polices surdimensionnées et ludiques, sauf si l'utilisateur le demande explicitement.
  • Rendez le mouvement du papier froissé déterministe.

Pour les cartes en verre :

  • Réutilisez .glass-card dim lower-third ou la classe existante la plus proche.
  • Préférez un placement en bas au centre.
  • Gardez les cartes compactes.
  • Utilisez les aides d'équation/de liste lorsque l'idée est structurelle.

Règles d'implémentation HyperFrames

Suivez AGENTS.md du projet et les règles de linting HyperFrames :

  • Chaque élément chronométré monté a besoin de data-start, data-duration et data-track-index.
  • Les éléments montés racine visibles et chronométrés doivent avoir la classe de clip/couche attendue par le projet.
  • Les sous-compositions doivent enregistrer une timeline GSAP en pause sur window.__timelines.
  • Épinglez chaque timeline de sous-composition avec tl.set({}, {}, SLOT);.
  • Gardez uniquement une logique déterministe.
  • N'animez pas les dimensions des éléments vidéo ou les propriétés média d'une manière qui peut geler les rendus.
  • Exécutez npx hyperframes lint après avoir modifié le HTML.

Lorsque vous ajoutez un beat :

  1. Créez compositions/beats/NNN-short-name.html.
  2. Ajoutez le montage racine dans index.html.
  3. Ajoutez ou mettez à jour le planning de visibilité maître s'il existe.
  4. Faites correspondre le SLOT de la sous-composition à la durée montée.
  5. Vérifiez qu'il n'y a pas de chevauchements sur la même piste, sauf si le projet utilise intentionnellement plusieurs pistes de superposition.

Analyse de couverture

Après les modifications, analysez le planning maître :

  • Listez les beats triés par début visible.
  • Affichez les vides au-dessus du seuil cible.
  • Ajoutez ou retimez les beats uniquement là où la transcription a un concept soutenable.

Pour ce modèle de projet, utilisez 30 secondes comme seuil d'analyse strict et 45 secondes comme seuil maximal acceptable pour le corps principal.

Validation

Avant de terminer :

  1. Exécutez le linter HyperFrames.
  2. Corrigez toutes les erreurs.
  3. Mentionnez les avertissements séparément s'ils sont connus et non bloquants.
  4. Si l'utilisateur a demandé un résultat prêt pour le rendu, effectuez un rendu ou un rendu test selon le cas.
  5. Donnez à l'utilisateur les chemins de fichiers exacts et les horodatages modifiés.

Paramètres par défaut pratiques

Utilisez ces paramètres par défaut, sauf si le contexte du projet dit le contraire :

  • Aperçu papier pleine écran : 8 à 10 secondes.
  • Statistique papier pleine écran : 5 à 8 secondes.
  • Explication en tiers inférieur en verre : 12 à 30 secondes.
  • Carte en verre pour sujet long : 25 à 45 secondes avec sous-éléments décalés.
  • Décalage de début de beat : 0,2 à 0,6 seconde.
  • Seuil d'analyse des vides : 30 secondes.
  • Largeur du tiers inférieur : environ 68-72vw, max environ 1240-1280px.

Ce qu'il faut préserver

Préservez les décisions de goût de l'utilisateur découvertes lors de la révision :

  • Si l'utilisateur dit qu'un beat est trop long, ne le restaurez pas simplement pour satisfaire une règle de couverture générique.
  • Si le style de carte en verre est approuvé, réutilisez-le au lieu de le reconcevoir.
  • Si la typographie est approuvée, gardez-la stable et ajustez uniquement la taille/le poids local.
  • Si le visage de l'orateur est important, préférez les cartes en tiers inférieur aux cartes plein écran.

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

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

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/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