Communitygithub.com

delorenj/skills

Traduisez une composition vidéo Remotion existante (basée sur React) en une composition HTML HyperFrames. N'utilisez que lorsque l'utilisateur demande explicitement de porter, convertir, migrer, traduire ou réécrire une composition Remotion vers HyperFrames.

Qu'est-ce que skills ?

Cette compétence permet de traduire mécaniquement des compositions vidéo Remotion (basées sur React) en compositions HyperFrames (HTML + GSAP). Environ 80 % des idiomes Remotion ont des équivalents directs dans HyperFrames, ce qui rend la traduction relativement simple pour la plupart des projets. Pour les 20 % restants, la compétence détecte les motifs problématiques (comme useState, useEffect, calculateMetadata asynchrone, bibliothèques de composants React tierces, @remotion/lambda) et recommande le modèle d'interopérabilité d'exécution (runtime interop pattern) basé sur la pull request #214, évitant ainsi les traductions imparfaites. La compétence utilise un corpus de tests échelonnés (T1–T4) avec des seuils SSIM validés pour garantir la fidélité visuelle. Elle est conçue pour être utilisée sur des projets Cursor ou Claude Code et prend en charge un workflow en cinq étapes : lint du code source Remotion, planification de la traduction avec une table de correspondance des API, génération de la composition HyperFrames, validation via un harnais d'évaluation (eval harness), et documentation des écarts dans un fichier TRANSLATION_NOTES.md.

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

Demander à votre IA préférée

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

Documentation

Remotion vers HyperFrames

Aperçu

Traduisez des compositions vidéo Remotion (basées sur React) en compositions HyperFrames (HTML + GSAP). La plupart des idiomes Remotion ont des équivalents directs dans HyperFrames — la traduction est mécanique pour environ 80 % des compositions typiques. Cette compétence encode la cartographie et se prémunit contre les 20 % problématiques en refusant de traduire les motifs qui ne correspondent pas au modèle basé sur la recherche d'HyperFrames (seek-driven model) et en recommandant à la place le modèle d'interopérabilité d'exécution (runtime interop pattern) de PR #214.

La compétence est livrée avec un corpus de tests échelonnés (T1–T4, 4 fixtures au total) qui évalue les traductions par rapport à des seuils SSIM mesurés. Ne traduisez pas sans exécuter l'évaluation — une traduction qui « semble correcte » mais dont le rendu est 0,05 SSIM inférieur à la référence validée est silencieusement erronée.

Quand utiliser

Utilisez cette compétence UNIQUEMENT lorsque l'utilisateur demande explicitement de migrer depuis Remotion. Exemples de phrases déclencheurs :

  • « porter mon projet Remotion vers HyperFrames »
  • « convertir ce code Remotion en HyperFrames »
  • « migrer depuis Remotion »
  • « traduire cette comp Remotion »
  • « réécrire ceci en HTML HyperFrames »

N'utilisez PAS cette compétence lorsque :

  • (a) L'utilisateur crée une nouvelle composition HyperFrames, même s'il a ou teste une vidéo Remotion similaire en A/B.
  • (b) L'utilisateur mentionne Remotion en passant sans demander de migration.
  • (c) L'utilisateur partage du code Remotion comme matériel de référence plutôt que de demander une traduction.
  • (d) L'utilisateur demande « la même vidéo que ma Remotion » sans demander explicitement de migrer la source — traitez cela comme une nouvelle construction HyperFrames.

En cas de doute, par défaut, créez une composition HyperFrames native avec la compétence hyperframes.

Workflow

Étape 1 : Linter la source

Exécutez scripts/lint_source.py sur le répertoire source Remotion. Le lint détecte les motifs qui ne peuvent pas être traduits proprement :

  • Bloqueurs (refuser + recommander l'interop) : useState, useReducer, useEffect/useLayoutEffect avec des dépendances non vides, calculateMetadata asynchrone, bibliothèques d'interface utilisateur React tierces (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Avertissements (traduire après avoir supprimé la construction) : configuration @remotion/lambda, delayRender, useCallback, useMemo, hooks personnalisés.
  • Infos (traduire avec une note) : staticFile, interpolateColors.

Si un bloqueur se déclenche, arrêtez-vous. Lisez references/escape-hatch.md et affichez le message de recommandation. Les avertissements n'arrêtent pas la traduction — supprimez la construction problématique à l'étape 3 et notez l'écart dans TRANSLATION_NOTES.md. La configuration @remotion/lambda est le cas d'avertissement canonique : la compétence supprime l'import et les appels renderMediaOnLambda(...) mais traduit le reste de la composition.

Étape 2 : Planifier la traduction

Lisez references/api-map.md — l'index de chaque API Remotion et de son équivalent HF ou de sa référence par sujet. Identifiez les références thématiques dont vous aurez besoin en fonction de ce que la source utilise :

La source contientCharger la référence
Composition, defaultProps, schema, calculateMetadataparameters.md
Sequence, Series, Loop, AbsoluteFill, Freezesequencing.md
useCurrentFrame, interpolate, spring, Easing, interpolateColorstiming.md
Audio, Video, Img, IFrame, staticFile, delayRendermedia.md
TransitionSeries, @remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>, Font.loadFont, @font-facefonts.md

Ne les chargez pas toutes — chargez uniquement ce dont la source spécifique a besoin.

Étape 3 : Générer la composition HF

Émettez index.html avec :

  • Un élément racine <div id="stage"> portant le data-composition-id de la composition, data-start="0", data-duration (en secondes), data-fps, data-width, data-height, plus un data-* par propriété scalaire.
  • Une liste plate de divs de scène avec data-start / data-duration / data-track-index.
  • Un <style> en ligne pour la mise en page ; CSS définit l'état from de chaque propriété animée.
  • Une seule balise <script> en bas contenant un gsap.timeline({paused: true}) en pause. Chaque dérivation de useCurrentFrame() de Remotion devient un tween sur cette timeline au décalage correct.
  • window.__timelines["<composition-id>"] = tl; enregistre la timeline avec l'exécution de HF.

Les sous-composants React personnalisés sont intégrés sous forme de HTML répété en utilisant l'interface de prop comme modèle (voir parameters.md pour le motif data-* par instance).

Étape 4 : Valider

Exécutez le harnais d'évaluation — references/eval.md pour le guide complet. Chemin rapide :

# Rendre la référence Remotion (après npm install dans la fixture)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# Rendre la traduction HF
cd ../hf-src && npx hyperframes render --output ../hf.mp4

# Diff SSIM
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff

Seuil : environ 0,02 en dessous du p05 du niveau de complexité de la source (voir le tableau des seuils validés de eval.md). Si le diff échoue, exécutez scripts/frame_strip.sh pour voir quelles images ont divergé, puis relisez la référence de timing/séquencement/média pertinente.

Critique : les deux rendus doivent utiliser un format de pixel correspondant. Définissez Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") dans le fichier remotion.config.ts de la source Remotion — sinon, le diff mesure les différences d'encodeur (environ 0,05 SSIM) et non la fidélité de la traduction.

Étape 5 : Documenter les écarts

Tout ce qui n'a pas été traduit proprement (rampes de volume abandonnées, présentations personnalisées approximées, polices substituées) doit être documenté dans un fichier TRANSLATION_NOTES.md placé à côté de la sortie HF. Voir references/limitations.md pour le format.

Ce que cette compétence ne fait PAS explicitement

  • Traduire les machines d'état React. Les compositions qui pilotent l'animation via useState + useEffect ne sont pas des cibles de capture d'images déterministes dans le modèle basé sur la recherche d'HyperFrames. Recommandez le modèle d'interopérabilité d'exécution.
  • Exécuter le pipeline de rendu Remotion parallèlement à HyperFrames. C'est le modèle d'interopérabilité d'exécution de PR #214 — une solution séparée pour les compositions qui échouent au lint de cette compétence.

(@remotion/lambda n'est pas un bloqueur — la configuration Lambda concerne le déploiement, pas l'animation. La compétence le supprime comme avertissement et traduit le reste. Voir references/escape-hatch.md.)

Comment noter votre propre traduction

Exécutez l'orchestrateur du corpus de tests :

./assets/test-corpus/run.sh

Il exécute T1, T2, T3 (rendu + diff) et T4 (validation du lint), affiche un tableau de réussite/échec par niveau et émet un rapport JSON agrégé. Utilisez-le pour vérifier que la compétence fonctionne de bout en bout sur un checkout propre — et comme vérification de régression après avoir modifié une référence.

Référence validée (au 27-04-2026) :

NiveauForme de la compositionSSIM moyenSeuil
T1Fade-in d'un élément unique0.9740.95
T2Multi-scène + ressort + audio + image0.9850.95
T3Piloté par les données, sous-composants personnalisés, compteur0.9530.90
T4Échappatoire (8 cas de lint)8/8 réussin/a

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

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

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

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