Communitygithub.com

delorenj/skills

Créez des compositions vidéo, animations, cartes-titres, incrustations, sous-titres, voix off, visuels réactifs à l'audio et transitions de scènes en HyperFrames HTML.

Qu'est-ce que skills ?

Cette compétence permet de construire des compositions vidéo complètes en utilisant HyperFrames HTML, un framework où le HTML est la source de vérité pour la vidéo. Elle couvre l'ensemble du flux de production : depuis la découverte du projet (comprendre l'intention de l'utilisateur) en passant par l'application d'un système de design (palette de couleurs, typographie) jusqu'à la rédaction et l'animation du HTML. Elle prend en charge les sous-titres synchronisés avec l'audio, la génération de voix off (text-to-speech), les animations réactives à l'audio (synchronisation sur le rythme, pulsation, lueur), le surlignement animé de texte (marqueurs, cercles, traits) et les transitions entre scènes (fondus, balayages, effets shader). La compétence repose sur une approche méthodique en trois étapes : établir le design system, développer le plan de composition et coder l'animation en partant de la mise en page finale. Les commandes CLI (init, lint, inspect, preview, render) sont gérées par une compétence dédiée, tout comme les tâches de prétraitement des médias (TTS, transcription, suppression d'arrière-plan).

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/hyperframes-upstream-hyperframes

Demander à votre IA préférée

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

Documentation

HyperFrames

HTML est la source de vérité pour la vidéo. Une composition est un fichier HTML avec des attributs data-* pour le timing, une timeline GSAP pour l'animation et du CSS pour l'apparence. Le framework gère la visibilité des clips, la lecture multimédia et la synchronisation de la timeline.

Approche

Découverte (requêtes exploratoires uniquement)

Pour les demandes ouvertes ("créez-moi une vidéo de lancement de produit", "créez quelque chose pour notre marque") où l'utilisateur ne s'est pas encore engagé sur une direction, comprenez d'abord l'intention avant de choisir les couleurs :

  • Audience — qui regarde cela ? Développeurs ? Cadres ? Consommateurs génériques ?
  • Plateforme — où est-ce diffusé ? Réseaux sociaux (15s), site web hero, démo produit, interne ?
  • Priorité — qu'est-ce qui importe le plus ? Qualité du mouvement ? Précision du contenu ? Fidélité à la marque ? Rapidité ?
  • Variations — l'utilisateur souhaite-t-il des options, ou une seule meilleure version ?

Pour les demandes spécifiques ("ajoutez une carte-titre", "corrigez le timing de la scène 3"), ignorez la découverte.

Pour les demandes exploratoires, envisagez de proposer 2 à 3 variations qui diffèrent de manière significative — pas seulement des changements de couleurs, mais différents rythmes, niveaux d'énergie ou approches structurelles. Une version prudente/attendue, une version ambitieuse. Ne le rendez pas obligatoire — c'est un outil disponible lorsque c'est pertinent.

Étape 1 : Système de design

Si design.md ou DESIGN.md existe dans le projet, lisez-le en premier (vérifiez les deux orthographes — ce sont des fichiers différents sous Linux). C'est la source de vérité pour les couleurs de la marque, les polices et les contraintes. Utilisez ses valeurs exactes — n'inventez pas de couleurs et ne remplacez pas les polices. N'importe quel format fonctionne (YAML frontmatter, prose, tableaux — extrayez simplement les valeurs).

S'il mentionne des polices que vous ne trouvez pas localement (pas de dossier fonts/ avec des fichiers .woff2, pas une police intégrée), prévenez l'utilisateur avant d'écrire le HTML : "design.md spécifie [nom de la police] mais aucun fichier de police trouvé. Veuillez ajouter des fichiers .woff2 dans le dossier fonts/ ou je vais utiliser [alternative intégrée la plus proche]."

Si aucun fichier design.md n'existe, proposez à l'utilisateur un choix :

  1. L'utilisateur a nommé un style ou une humeur ? → Lisez visual-styles.md pour les 8 presets nommés. Choisissez la correspondance la plus proche.
  2. Souhaitez-vous parcourir les options visuellement ? → Lancez le sélecteur de design : lisez references/design-picker.md pour le flux complet. Ceci sert une page de sélection visuelle. L'utilisateur configure l'humeur, la palette, la typographie et le mouvement dans le navigateur, puis copie le design.md généré et le colle dans la conversation.
  3. Voulez-vous passer directement et aller vite ? → Demandez : humeur, clair ou sombre, des couleurs/polices de marque ? Choisissez ensuite une palette dans house-style.md.

design.md définit la marque. Il ne définit pas les règles de composition vidéo. Celles-ci proviennent de references/video-composition.md et house-style.md. Utilisez les couleurs de la marque à une échelle adaptée à la vidéo — pas à l'opacité de l'interface utilisateur Web.

Étape 2 : Expansion de la demande

Toujours exécuter sur chaque composition (sauf les pièces à scène unique et les modifications triviales). Cette étape ancre l'intention de l'utilisateur par rapport à design.md et house-style.md et produit un intermédiaire cohérent que chaque agent en aval lit de la même manière.

Lisez references/prompt-expansion.md pour le processus complet et le format de sortie.

Étape 3 : Planification

Avant d'écrire le HTML, réfléchissez à un niveau élevé :

  1. Quoi — que doit voir le spectateur ? Identifiez l'arc narratif, les moments clés et les battements émotionnels.
  2. Structure — combien de compositions, lesquelles sont des sous-compositions ou en ligne, quelles pistes transportent quoi (vidéo, audio, incrustations, sous-titres).
  3. Rythme — déclarez votre rythme de scène avant de l'implémenter. Quelles scènes sont rapides, lesquelles sont lentes, où les shaders atterrissent, où le pic d'énergie se situe. Nommez le modèle : rapide-rapide-LENT-rapide-SHADER-lent. Lisez references/beat-direction.md pour les modèles de rythme.
  4. Timing — quels clips déterminent la durée, où les transitions atterrissent, quel est le rythme.
  5. Disposition — construisez d'abord l'état final. Voir "Disposition avant Animation" ci-dessous.
  6. Animer — ajoutez ensuite du mouvement en utilisant les règles ci-dessous.

Construisez ce qui a été demandé. Une demande pour "une carte-titre" n'est pas une demande pour "une carte-titre + 3 scènes de soutien + musique d'ambiance + sous-titres." Chaque scène, chaque élément, chaque interpolation doit mériter sa place. Si des scènes ou éléments supplémentaires amélioreraient réellement la pièce, proposez-les — ne les ajoutez pas.

Pour les petites modifications (corriger une couleur, ajuster le timing, ajouter un élément), passez directement aux règles.

Disposition avant Animation

Positionnez chaque élément là où il doit être à son moment le plus visible — l'image où il est complètement entré, correctement placé, et pas encore sorti. Écrivez cela d'abord en HTML+CSS statique. Pas encore de GSAP.

Pourquoi c'est important : Si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle à 0, opacité 0) et que vous les animez jusqu'à l'endroit où vous pensez qu'ils doivent atterrir, vous devinez la mise en page finale. Les chevauchements sont invisibles jusqu'à ce que la vidéo soit rendue. En construisant d'abord l'état final, vous pouvez voir et corriger les problèmes de mise en page avant d'ajouter tout mouvement.

Le processus

  1. Identifiez l'image héroïque pour chaque scène — le moment où le plus d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
  2. Écrivez le CSS statique pour cette image. Le conteneur .scene-content DOIT remplir toute la scène en utilisant width: 100%; height: 100%; padding: Npx; avec display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Utilisez le padding pour pousser le contenu vers l'intérieur — JAMAIS position: absolute; top: Npx sur un conteneur de contenu. Les conteneurs de contenu positionnés en absolu débordent lorsque le contenu est plus grand que l'espace restant. Réservez position: absolute uniquement pour les éléments décoratifs.
  3. Ajoutez les entrées avec gsap.from() — animez DEPUIS l'état hors écran/invisible VERS la position CSS. La position CSS est la vérité terrain ; l'interpolation décrit le chemin pour y arriver. (Dans les sous-compositions chargées via data-composition-src, préférez gsap.fromTo() — voir les règles GSAP critiques dans references/motion-principles.md.)
  4. Ajoutez les sorties avec gsap.to() — animez VERS l'état hors écran/invisible DEPUIS la position CSS.

Exemple

/* scene-content remplit la scène, le padding positionne le contenu */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* Le conteneur remplit n'importe quelle taille de scène (1920x1080, 1080x1920, etc.).
   Le padding positionne le contenu. Flex + gap gère l'espacement. */

MAUVAIS — dimensions codées en dur et positionnement absolu :

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Étape 3 : Animez VERS ces positions
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Étape 4 : Animez HORS de ces positions
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Lorsque des éléments partagent un espace dans le temps

Si un élément A sort avant qu'un élément B n'entre dans la même zone, les deux doivent avoir des positions CSS correctes pour leurs images héroïques respectives. L'ordre de la timeline garantit qu'ils ne coexistent jamais visuellement — mais si vous sautez l'étape de disposition, vous ne détecterez pas le cas où ils se chevauchent accidentellement en raison d'une erreur de timing.

Ce qui compte comme chevauchement intentionnel

Les effets en couches (lueur derrière le texte, éléments d'ombre, motifs d'arrière-plan) et les conceptions en z-stack (piles de cartes, couches de profondeur) sont intentionnels. L'étape de disposition consiste à détecter les chevauchements non intentionnels — deux titres atterrissant l'un sur l'autre, une statistique couvrant un libellé, du contenu débordant du cadre.

Attributs de données

Tous les clips

AttributRequisValeurs
idOuiIdentifiant unique
data-startOuiSecondes ou référence d'ID de clip ("el-1", "intro + 2")
data-durationRequis pour img/div/compositionsSecondes. Vidéo/audio par défaut = durée du média.
data-track-indexOuiEntier. Les clips sur la même piste ne peuvent pas se chevaucher.
data-media-startNonDécalage de rognage dans la source (secondes)
data-volumeNon0-1 (par défaut 1)

data-track-index n'affecte pas l'ordre visuel des couches — utilisez le CSS z-index.

Clips de composition

AttributRequisValeurs
data-composition-idOuiID de composition unique
data-startOuiTemps de début (composition racine : utilisez "0")
data-durationOuiPrioritaire sur la durée de la timeline GSAP
data-width / data-heightOuiDimensions en pixels (1920x1080 ou 1080x1920)
data-composition-srcNonChemin vers un fichier HTML externe
data-variable-valuesNonObjet JSON de remplacements par instance pour les variables d'une sous-comp hôte

Sur l'élément racine <html> :

AttributRequisValeurs
data-composition-variablesNonTableau JSON de variables déclarées (id/type/label/default) — pilote l'interface d'édition Studio et fournit les valeurs par défaut pour getVariables()

Structure de composition

Les sous-compositions chargées via data-composition-src utilisent un wrapper <template>. Les compositions autonomes (le fichier index.html principal) n'utilisent PAS <template> — elles placent le div data-composition-id directement dans <body>. Utiliser <template> sur un fichier autonome masque tout le contenu du navigateur et interrompt le rendu.

Structure de sous-composition :

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenu -->
    <style>
      [data-composition-id="my-comp"] {
        /* styles délimités */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // interpolations...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Chargement dans la racine : <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Variables (Compositions paramétrées)

Rendez la même composition avec un contenu différent — titre, couleur de thème, prix, sous-titres — sans modifier le HTML source.

Modèle en trois étapes :

  1. Déclarez des variables sur la racine <html> de la composition avec data-composition-variables. Chaque entrée nécessite id, type (une de string, number, color, boolean, enum), label, et default. Les entrées de type enum nécessitent également options: [{value, label}, ...].
  2. Lisez les valeurs résolues à l'intérieur du script de la composition avec window.__hyperframes.getVariables(). Renvoie le résultat fusionné des valeurs par défaut déclarées + des remplacements par instance + des remplacements CLI.
  3. Remplacez au moment du rendu avec npx hyperframes render --variables '{...}' (niveau supérieur) ou avec data-variable-values='{...}' sur l'élément hôte (par instance pour les sous-compositions).
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Titre","default":"Bonjour"},
  {"id":"theme","type":"enum","label":"Thème","default":"light","options":[
    {"value":"light","label":"Clair"},
    {"value":"dark","label":"Sombre"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# L'aperçu de développement utilise les valeurs par défaut déclarées
npx hyperframes preview

# Rendu avec remplacements
npx hyperframes render --variables '{"title":"Rapport Q4","theme":"dark"}' --output q4.mp4

# Ou à partir d'un fichier JSON
npx hyperframes render --variables-file ./vars.json

Valeurs par instance de sous-composition : le même getVariables() fonctionne à l'intérieur des sous-compositions chargées via data-composition-src. Chaque élément hôte transmet ses propres valeurs :

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"29€"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Entreprise","price":"99€"}'
></div>

[Le contenu complet a été tronqué précédemment par l'utilisateur. Ce qui précède est une traduction complète de tout ce qui a été fourni.]

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

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.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Skills associés