Communitygithub.com

Lord1Egypt/awesome-skill-forge

Créez des compositions vidéo en HTML : cartes titres animées, incrustations sociales, vidéos de tête parlante avec sous-titres, visuels réactifs à l’audio et transitions shader avec HyperFrames. L’HTML est la source de vérité pour la vidéo.

Qu'est-ce que awesome-skill-forge ?

Ce skill permet à un agent IA de générer des vidéos MP4 ou WebM à partir de compositions HTML, en utilisant le framework HyperFrames. Il est idéal pour produire des animations graphiques, des vidéos de tête parlante avec sous-titres synchronisés, des incrustations sociales, des transitions entre scènes, des visuels réactifs à l’audio (pulsations, barres de spectre) et même des captures de site web transformées en vidéo promotionnelle. Le flux de travail est structuré : planification, définition d’une identité visuelle (via DESIGN.md), échafaudage du projet avec `npx hyperframes init`, conception de la composition HTML (layout statique puis animation GSAP), puis rendu avec `npx hyperframes render`. Le skill inclut des vérifications de qualité (lint, validation de contraste WCAG, inspection de mise en page) et des commandes pour ajouter des transitions shader, du texte-à-parole (TTS), et la transcription audio. Il s’appuie sur Node.js, FFmpeg et Chrome headless, et exige le non-respect de certaines règles (pas de `repeat: -1`, pas de construction asynchrone des timelines) pour garantir un rendu déterministe. Il est conçu pour Claude Code, Cursor, Codex et d’autres agents de développement.

Compatible avec✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Lord1Egypt/awesome-skill-forge/tree/HEAD/optional-skills/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

L’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 moteur HyperFrames capture la page image par image et encode en MP4/WebM avec FFmpeg.

Complément à manim-video : Utilisez manim-video pour les explications mathématiques/géométriques (équations, style 3B1B). Utilisez hyperframes pour les graphiques animés, les têtes parlantes avec sous-titres, les visites guidées de produits, les incrustations sociales, les transitions shader et tout ce qui est basé sur des médias vidéo/audio réels.

Quand l’utiliser

  • L’utilisateur demande une vidéo rendue à partir d’un texte, d’un script ou d’un site web
  • Cartes titres animées, tiers inférieurs ou intros typographiques
  • Vidéo de narration sous-titrée (TTS + sous-titres synchronisés sur la forme d’onde)
  • Visuels réactifs à l’audio (synchronisation de battements, barres de spectre, lueur pulsée)
  • Transitions de scène à scène (fondu enchaîné, balayage, déformation shader, flash blanc)
  • Incrustations sociales (style Instagram/TikTok/YouTube)
  • Pipeline site web vers vidéo (capturer une URL, produire une promotion)
  • Toute animation HTML/CSS/JS qui doit être rendue de manière déterministe en fichier vidéo

N’utilisez pas ce skill pour :

  • L’animation pure de mathématiques/équations (→ manim-video)
  • La génération d’images ou les mèmes (→ meme-generation, modèles d’images)
  • La visioconférence ou le streaming en direct

Référence rapide

npx hyperframes init my-video               # créer la structure d’un projet
cd my-video
npx hyperframes lint                        # valider avant prévisualisation/rendu
npx hyperframes preview                     # prévisualisation en direct (port 3002)
npx hyperframes render --output final.mp4   # rendre en MP4
npx hyperframes doctor                      # diagnostiquer les problèmes d’environnement

Indicateurs de rendu : --quality draft|standard|high · --fps 24|30|60 · --format mp4|webm · --docker (reproductible) · --strict.

Référence complète de la CLI : references/cli.md.

Configuration (une fois)

bash "$(dirname "$(find ~/.hermes/skills -path '*/hyperframes/SKILL.md' 2>/dev/null | head -1)")/scripts/setup.sh"

Le script :

  1. Vérifie que Node.js >= 22 et FFmpeg sont installés (affiche des instructions de correction si ce n’est pas le cas).
  2. Installe la CLI hyperframes globalement (npm install -g hyperframes@>=0.4.2).
  3. Pré-met en cache chrome-headless-shell via Puppeteer — nécessaire pour un rendu de la meilleure qualité via le chemin de capture HeadlessExperimental.beginFrame de Chrome.
  4. Exécute npx hyperframes doctor et rapporte le résultat.

Consultez references/troubleshooting.md si la configuration échoue.

Procédure

1. Planifier avant d’écrire le HTML

Avant de toucher au code, articulez à un haut niveau :

  • Quoi — arc narratif, moments clés, points émotionnels
  • Structure — compositions, pistes (vidéo/audio/incrustations), durées
  • Identité visuelle — couleurs, polices, caractère du mouvement (explosif / cinématique / fluide / technique)
  • Image clé — pour chaque scène, le moment où le plus d’éléments sont simultanément visibles. C’est la mise en page statique que vous construirez d’abord.

Barrière d’identité visuelle (BARRIÈRE DURE). Avant d’écrire UNE composition HTML, une identité visuelle doit être définie. N’écrivez PAS de compositions avec des couleurs par défaut ou génériques (#333, #3b82f6, Roboto sont des signes que cette étape a été sautée). Vérifiez dans l’ordre :

  1. DESIGN.md à la racine du projet ? → Utilisez ses couleurs, polices, règles de mouvement exactes et contraintes « Ce qu’il ne faut PAS faire ».

  2. L’utilisateur a nommé un style (par exemple « Swiss Pulse », « sombre et technique », « marque de luxe ») ? → Générez un DESIGN.md minimal avec ## Style Prompt, ## Colors (3-5 hex avec rôles), ## Typography (1-2 familles), ## What NOT to Do (3-5 anti-patrons).

  3. Aucun des cas ci-dessus ? → Posez 3 questions avant d’écrire du HTML :

    • Ambiance ? (explosif / cinématique / fluide / technique / chaotique / chaleureux)
    • Toile claire ou sombre ?
    • Des couleurs, polices ou références visuelles de marque ?

    Générez ensuite un DESIGN.md à partir des réponses. Chaque composition doit faire remonter sa palette et sa typographie à DESIGN.md ou à une directive explicite de l’utilisateur.

2. Échafauder

npx hyperframes init my-video --non-interactive

Modèles : blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph. Passez --example <nom> pour en choisir un, --video clip.mp4 ou --audio track.mp3 pour amorcer avec des médias.

3. Mise en page avant animation

Écrivez d’abord le HTML+CSS statique de l’image clé — pas encore de GSAP. Le conteneur .scene-content doit remplir la scène (width:100%; height:100%; padding:Npx) avec display:flex + gap. Utilisez padding pour pousser le contenu vers l’intérieur — jamais position: absolute; top: Npx sur un conteneur de contenu (le contenu déborde lorsqu’il est plus haut que l’espace restant).

Ce n’est qu’après que l’image clé a l’air correcte que vous ajoutez les entrées gsap.from() (animer vers la position CSS) et les sorties gsap.to() (animer depuis celle-ci).

Consultez references/composition.md pour le schéma complet des attributs data et les règles de composition.

4. Animer avec GSAP

Chaque composition doit :

  • Enregistrer sa timeline : window.__timelines["<composition-id>"] = tl
  • Démarrer en pause : gsap.timeline({ paused: true }) — le lecteur contrôle la lecture
  • Utiliser des valeurs repeat finies (pas de repeat: -1 — casse le moteur de capture). Calculez : repeat: Math.ceil(duration / cycleDuration) - 1.
  • Être déterministe — pas de Math.random(), Date.now() ou logique basée sur l’horloge système. Utilisez un PRNG ensemencé si vous avez besoin de pseudo-aléatoire.
  • Se construire de manière synchrone — pas de async/await, setTimeout ou Promesses autour de la construction de la timeline.

Consultez references/gsap.md pour l’API GSAP de base (tweens, eases, stagger, timelines).

5. Transitions entre les scènes

Les compositions multi-scènes nécessitent des transitions. Règles :

  1. Utilisez toujours une transition entre les scènes — pas de cut sec.
  2. Utilisez toujours des animations d’entrée sur chaque élément de scène (gsap.from(...)).
  3. N’utilisez jamais d’animations de sortie sauf sur la scène finale — la transition EST la sortie.
  4. La scène finale peut s’estomper.

Utilisez npx hyperframes add <nom-transition> pour installer des transitions shader (flash-through-white, liquid-wipe, etc.). Liste complète : npx hyperframes add --list.

6. Audio, sous-titres, TTS, audio-réactif, surlignage

  • Audio : toujours un élément <audio> séparé (la vidéo est muted playsinline).
  • TTS : npx hyperframes tts "Texte du script" --voice af_nova --output narration.wav. Listez les voix avec --list. La première lettre de l’ID de la voix encode la langue (a/b=Anglais, e=Espagnol, f=Français, j=Japonais, z=Mandarin, etc.) — la CLI devine automatiquement la locale du phonémiseur ; passez --lang uniquement pour la surcharger. La phonémisation non anglaise nécessite espeak-ng installé sur le système.
  • Sous-titres : npx hyperframes transcribe narration.wav → transcription mot par mot. Choisissez le style en fonction du ton de la transcription (hype / corporate / tutorial / storytelling / social — voir le tableau dans references/features.md). Règle de langue : n’utilisez jamais les modèles whisper .en sauf si l’audio est confirmé en anglais — .en traduit l’audio non anglais au lieu de le transcrire. Chaque groupe de sous-titres DOIT avoir une terminaison dure tl.set(el, { opacity: 0, visibility: "hidden" }, group.end) après son tween de sortie — sinon les groupes fuient visuellement dans les suivants.
  • Visuels audio-réactifs : extrayez au préalable les bandes audio (basses / médiums / aigus) et échantillonnez par image à l’intérieur de la timeline avec une boucle for de tl.call(draw, [], f / fps) — une seule longue tween ne réagit PAS à l’audio. Mappez les basses → scale (pulsation), aigus → textShadow/boxShadow (lueur), amplitude globale → opacity/y/backgroundColor. Évitez les clichés de barres d’égaliseur — laissez le contenu guider le visuel, l’audio piloter son comportement.
  • Surlignage de type marqueur : les effets de surlignage, cercle, éclat, gribouillage, contour pour l’emphase du texte sont du CSS+GSAP déterministe — voir references/features.md#marker-highlighting. Entièrement navigables, pas de filtres SVG animés.
  • Transitions de scènes : toute composition multi-scènes DOIT utiliser des transitions (pas de cuts secs). Choisissez parmi les primitives CSS (glissement, fondu enchaîné flou, zoom traversant, blocs décalés) ou les transitions shader (flash-through-white, liquid-wipe, cross-warp-morph, chromatic-split, etc.) via npx hyperframes add. Les tables d’ambiance et d’énergie se trouvent dans references/features.md#transitions. Ne mélangez pas les transitions CSS et shader dans la même composition.

7. Lint, valider, inspecter, prévisualiser, rendre

npx hyperframes lint              # détecte les data-composition-id manquants, pistes qui se chevauchent, timelines non enregistrées
npx hyperframes validate          # audit de contraste WCAG à 5 timestamps
npx hyperframes inspect           # audit de mise en page visuelle — débordement, éléments hors cadre, texte occulté
npx hyperframes preview           # prévisualisation en direct
npx hyperframes render --quality draft --output draft.mp4    # itération rapide
npx hyperframes render --quality high --output final.mp4     # livraison finale

hyperframes validate échantillonne les pixels d’arrière-plan derrière chaque élément de texte et avertit sur les ratios de contraste inférieurs à 4,5:1 (ou 3:1 pour les grands textes). hyperframes inspect est le compagnon de mise en page — il exécute la page à plusieurs timestamps et signale les problèmes qu’un lint statique ne peut pas voir (un sous-titre qui dépasse la zone de sécurité seulement à 4,5s, une carte qui déborde quand son titre est la variante la plus longue, un élément qui finit derrière un shader de transition). Exécutez inspect en particulier sur les compositions avec des bulles de dialogue, des cartes, des sous-titres ou une typographie serrée.

8. Site web vers vidéo (si l’utilisateur donne une URL)

Utilisez le workflow de capture en 7 étapes dans references/website-to-video.md : capture → DESIGN.md → SCRIPT.md → storyboard → composition → render → deliver.

Pièges

  • HeadlessExperimental.beginFrame introuvable — Chromium 147+ a supprimé ce protocole. Assurez-vous d’être sur hyperframes@>=0.4.2 (détection automatique et repli en mode capture d’écran). Échappatoire : export PRODUCER_FORCE_SCREENSHOT=true. Voir hyperframes#294 et references/troubleshooting.md.
  • Chrome système (pas chrome-headless-shell) — les rendus bloquent pendant 120s puis expirent. Exécutez npx puppeteer browsers install chrome-headless-shell (setup.sh le fait). hyperframes doctor indique quel binaire sera utilisé.
  • repeat: -1 n’importe où — casse le moteur de capture. Calculez toujours un nombre de répétitions fini.
  • gsap.set() sur des éléments de clip qui entrent plus tard — l’élément n’existe pas au chargement de la page. Utilisez tl.set(selector, vars, timePosition) à l’intérieur de la timeline à la place, au moment ou après le data-start du clip.
  • <br> à l’intérieur du texte de contenu — les sauts forcés ne connaissent pas la largeur de police rendue, donc le retour à la ligne naturel + <br> double les sauts. Utilisez max-width pour laisser le texte s’enrouler. Exception : les titres d’affichage courts où chaque mot est délibérément sur sa propre ligne.
  • Animer visibility ou display — GSAP ne peut pas tween these. Utilisez autoAlpha (gère à la fois visibility et opacity).
  • Appeler video.play() ou audio.play() — le framework possède la lecture. Ne les appelez jamais vous-même.
  • Construire les timelines de manière asynchrone — le moteur de capture lit window.__timelines de manière synchrone après le chargement de la page. N’enveloppez jamais la construction de la timeline dans async, setTimeout ou une Promesse.
  • index.html autonome enveloppé dans <template> — cache tout le contenu au navigateur. Seules les sous-compositions chargées via data-composition-src utilisent <template>.
  • Utiliser la vidéo pour l’audio — toujours <video> en mute + <audio> séparé.

Vérification

Avant et après le rendu :

  1. Lint + validate + inspect réussis : npx hyperframes lint --strict && npx hyperframes validate && npx hyperframes inspect (lint détecte les problèmes structurels, validate les problèmes de contraste, inspect les problèmes de mise en page visuelle / débordement — voir troubleshooting.md si des avertissements apparaissent).
  2. Chorégraphie d’animation — pour les nouvelles compositions ou les changements d’animation significatifs, exécutez la carte d’animation. npx hyperframes init copie les scripts du skill dans le projet, donc le chemin est local au projet :
    node skills/hyperframes/scripts/animation-map.mjs <composition-dir> \
      --out <composition-dir>/.hyperframes/anim-map
    
    Produit un seul fichier animation-map.json avec des résumés par tween, une timeline Gantt ASCII, la détection de décalage, les zones mortes (>1s sans animation), les cycles de vie des éléments et des indicateurs (offscreen, collision, invisible, paced-fast <0.2s, paced-slow >2s). Parcourez les résumés et les indicateurs — corrigez ou justifiez chacun. Sautez sur les petites modifications.
  3. Le fichier existe et n’est pas vide : ls -lh final.mp4.
  4. La durée correspond à data-duration : ffprobe -v error -show_entries format=duration -of default=nw=1:nk=1 final.mp4.
  5. Vérification visuelle : extrayez une image à mi-composition : ffmpeg -i final.mp4 -ss 00:00:05 -vframes 1 preview.png.
  6. Audio présent si attendu : ffprobe -v error -show_streams -select_streams a -of default=nw=1:nk=1 final.mp4 | head -1.

Si hyperframes render échoue, exécutez npx hyperframes doctor et joignez sa sortie lors du rapport.

Références

  • composition.md — attributs data, contrat de timeline, règles non négociables, règles de typographie/ressources
  • cli.md — chaque commande CLI (init, capture, lint, validate, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, benchmark)
  • gsap.md — API GSAP de base pour HyperFrames (tweens, eases, stagger, timelines, matchMedia)
  • features.md — sous-titres, TTS, audio-réactif, surlignage de marqueur, transitions (chargement à la demande)
  • website-to-video.md — workflow de capture en 7 étapes
  • troubleshooting.md — correction OpenClaw, variables d’environnement, erreurs de rendu courantes

Individual skills in this repo

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

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a insurance agency. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generates a complete landing page with copy, layout, hero image, and responsive design from a text description. Use when launching a product quickly.

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a family law practice. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a fractional CFO firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a home remodeling company. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a HVAC service company. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a immigration law firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a CPA tax advisory firm. Use when handling offer...

Lord1Egypt/awesome-skill-forge

Generate a conversion-focused landing page that compares offers, pricing cues, and trust signals for a estate planning law firm. Use when handling...

Lord1Egypt/awesome-skill-forge

Fastest way to create or update a pawr.link profile. One curl command, $19 USDC to create, $0.10 to update. Patch-style update-links endpoint lets you add, remove, or move individual links without replacing the whole profile.

Lord1Egypt/awesome-skill-forge

Use this skill when the user wants to review today, look back on yesterday, reflect on this week, or wrap things up with a gentle, low-pressure reflection.

Lord1Egypt/awesome-skill-forge

Read-only queue dashboard for workspace-aware ship. (gstack)

Lord1Egypt/awesome-skill-forge

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, LP audit, conversion rate, landing page CRO, post-click CRO, or landing page optimization.

Lord1Egypt/awesome-skill-forge

Search arXiv papers by keyword, author, category, or ID.

Lord1Egypt/awesome-skill-forge

Delegate coding to OpenAI Codex CLI (features, PRs).

Lord1Egypt/awesome-skill-forge

Track Apple devices/AirTags via FindMy.app on macOS.

Lord1Egypt/awesome-skill-forge

Jailbreak LLMs: Parseltongue, GODMODE, ULTRAPLINIAN.

Lord1Egypt/awesome-skill-forge

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.

Lord1Egypt/awesome-skill-forge

Notion API + ntn CLI: pages, databases, markdown, Workers.

Lord1Egypt/awesome-skill-forge

p5.js sketches: gen art, shaders, interactive, 3D.

Skills associés