Communitygithub.com

Biznomad/agent-skills

Traduire une composition vidéo Remotion (basée sur React) en une composition HTML HyperFrames. À utiliser UNIQUEMENT lorsque l'utilisateur demande explicitement de porter, convertir, migrer, traduire ou réécrire une composition Remotion vers HyperFrames (par ex. « portez mon projet Remotion vers HyperFrames »). Ne PAS utiliser pour (a) créer une NOUVELLE composition HyperFrames (même pour un test A/B avec une vidéo Remotion) ; (b) mentionner Remotion en passant ; (c) partager du code Remotion comme référence, sans demande de traduction ; (d) demander « la même vidéo que ma Remotion » sans migration explicite du code source — traiter comme une nouvelle construction HyperFrames. En cas de doute, utiliser par défaut la compétence `hyperframes`. Détecte les motifs non supportés (useState, useEffect avec effets de bord, calculateMetadata asynchrone, bibliothèques de composants React tierces, `@remotion/lambda`) et recommande l'échappatoire d'interopérabilité runtime plutôt qu'une traduction avec perte.

Qu'est-ce que agent-skills ?

Cette compétence d'agent spécialisée traduit mécaniquement les compositions vidéo Remotion (basées sur React) en compositions HyperFrames (HTML + GSAP). Elle mappe environ 80 % des idiomes Remotion vers leurs équivalents HyperFrames directs, mais refuse de traduire les 20 % restants (motifs non déterministes comme `useState`/`useEffect`, `calculateMetadata` asynchrone, ou bibliothèques React tierces) en recommandant un motif d'échappatoire d'interopérabilité runtime (voir PR #214). La compétence est déclenchée uniquement sur demande explicite de migration (par exemple, « portez mon projet Remotion vers HyperFrames ») et non pour des créations originales ou de simples références. Elle comprend un pipeline de validation en 5 étapes : lint du code source, planification via une table de mappage d'API, génération d'un fichier `index.html` avec timeline GSAP, validation via un corpus de tests (4 échantillons T1-T4 avec seuils SSIM), et documentation des écarts dans un fichier `TRANSLATION_NOTES.md`. Les motifs bloquants (comme useState pour les machines d'état) déclenchent un arrêt immédiat avec une recommandation d'interopérabilité, tandis que les avertissements (comme la configuration `@remotion/lambda`) sont ignorés sans bloquer la traduction. Le corpus de tests automatisé vérifie la fidélité de la traduction avec des seuils SSIM allant de 0.974 pour des compositions simples à 0.953 pour des compositions complexes avec sous-composants personnalisés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-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

Traduire 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 le mappage et se prémunit contre les 20 % avec perte en refusant de traduire les motifs qui ne correspondent pas au modèle piloté par la recherche (seek-driven) de HF et en recommandant le motif d'interopérabilité runtime du PR #214 à la place.

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

Quand l'utiliser

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

  • « portez mon projet Remotion vers HyperFrames »
  • « convertissez ce code Remotion en HyperFrames »
  • « migrez depuis Remotion »
  • « traduisez cette comp Remotion »
  • « réécrivez ceci en HTML HyperFrames »

N'utilisez PAS cette compétence quand :

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

En cas de doute, utilisez par défaut la compétence hyperframes pour créer une composition HyperFrames native.

Flux de travail

Étape 1 : Analyser le code source

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

  • Bloqueurs (refuser + recommander l'interopérabilité) : 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.
  • Info (traduire avec une note) : staticFile, interpolateColors.

Si un bloqueur est déclenché, 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 incriminée à l'étape 3 et notez l'écart dans TRANSLATION_NOTES.md. La configuration @remotion/lambda est le cas canonique d'avertissement : 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 son équivalent HF ou 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/<Famille>, Font.loadFont, @font-facefonts.md

Ne les chargez pas tous — ne chargez que ce dont la source spécifique a besoin.

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

Émettez index.html avec :

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

Les sous-composants React personnalisés sont intégrés sous forme de HTML répété en utilisant l'interface des props 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 le jeu d'essai)
cd remotion-src && npx remotion render <IdComposition> out/baseline.mp4

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

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

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

Critique : les deux rendus doivent utiliser un format de pixels correspondant. Définissez Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") dans le fichier remotion.config.ts de la source Remotion — sinon la différence mesure les différences d'encodeur (impact SSIM d'environ 0,05), 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 supprimées, présentations personnalisées approximées, polices substituées) reçoit un fichier TRANSLATION_NOTES.md écrit à 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 déterministes de capture d'images dans le modèle piloté par la recherche d'HyperFrames. Recommandez le motif d'interopérabilité runtime.
  • Exécuter le pipeline de rendu de Remotion en parallèle d'HyperFrames. C'est le motif d'interopérabilité runtime du PR #214 — une solution séparée pour les compositions qui échouent à l'analyse 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 un avertissement et traduit le reste. Voir references/escape-hatch.md.)

Comment évaluer votre propre traduction

Exécutez l'orchestrateur du corpus de tests :

./assets/test-corpus/run.sh

Il exécute T1, T2, T3 (rendu + différence) et T4 (validation par analyse), affiche un tableau 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 répertoire vierge — et comme vérification de régression après toute modification d'une référence.

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

NiveauForme de la compositionSSIM moyenSeuil
T1fondu d'entrée d'un élément unique0,9740,95
T2multi-scène + ressort + audio + image0,9850,95
T3piloté par données, sous-composants personnalisés, compteur0,9530,90
T4échappatoire (8 cas d'analyse)8/8 réussiten/a

Individual skills in this repo

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

Biznomad/agent-skills

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", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-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.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

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

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Skills associés