Communitygithub.com

Biznomad/claude-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 en HyperFrames (par exemple « porte mon projet Remotion vers HyperFrames »).

Qu'est-ce que claude-skills ?

Cette compétence spécialisée traduit mécaniquement les compositions vidéo Remotion (basées sur React) en compositions HyperFrames (HTML + GSAP), couvrant environ 80 % des cas d'usage typiques. Elle fournit un mappage API complet de Remotion vers HyperFrames, détecte automatiquement les motifs non traduisibles (comme `useState`, `useEffect` avec dépendances, `calculateMetadata` asynchrone, bibliothèques tierces React, `@remotion/lambda`) et recommande le modèle d'interopérabilité d'exécution comme alternative. La compétence inclut un corpus de test à plusieurs niveaux (T1-T4) avec des seuils SSIM validés pour garantir la fidélité de la traduction. Le flux de travail comprend cinq étapes : analyse du code source Remotion pour détecter les motifs bloquants, planification de la traduction à l'aide de références ciblées, génération du fichier `index.html` HyperFrames avec une timeline GSAP, validation via un harnais de test comparant les rendus Remotion et HyperFrames, et documentation des écarts dans `TRANSLATION_NOTES.md`. Cette compétence ne traduit pas les machines d'état React ni n'exécute le pipeline de rendu Remotion. Elle prend en charge les plateformes Claude Code, Cursor et Codex.

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

Vue d'ensemble

Traduire les 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 ~80% des compositions typiques. Cette compétence encode le mappage et se prémunit contre les 20% problématiques en refusant de traduire les motifs qui ne correspondent pas au modèle piloté par la recherche (seek-driven) d'HyperFrames et en recommandant plutôt le motif d'interopérabilité d'exécution décrit dans PR #214.

La compétence est livrée avec un corpus de test hiérarchisé (T1–T4, 4 montages 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 qui donne 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 d'expressions déclencheuses :

  • « porte mon projet Remotion vers HyperFrames »
  • « convertit ce code Remotion en HyperFrames »
  • « migre depuis Remotion »
  • « traduit cette comp Remotion »
  • « réécris ceci en HTML HyperFrames »

N'utilisez PAS cette compétence lorsque :

  • (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 matériel de référence plutôt que de demander une traduction.
  • (d) L'utilisateur demande « la même vidéo que ma vidéo Remotion » sans demander explicitement de migrer la source — traitez cela comme une nouvelle création HyperFrames.

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

Flux de travail

Étape 1 : Analyse du 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 dépendances non vides, calculateMetadata asynchrone, bibliothèques UI 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.
  • Informations (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'importation + 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 HyperFrames ou 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 tous — chargez uniquement ce dont la source spécifique a besoin.

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

Émettez index.html avec :

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

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 :

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

# Rendu de la traduction HyperFrames
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 : ~0,02 en dessous du p05 du niveau de complexité de la source (voir le tableau des seuils validés de 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 de timing/séquençage/média concernée.

Critique : les deux rendus doivent utiliser un format de pixel correspondant. Définissez Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") dans le remotion.config.ts de la source Remotion — sinon la différence mesure les différences d'encodeur (~0,05 SSIM de pénalité), 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 TRANSLATION_NOTES.md écrit à côté de la sortie HyperFrames. 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é d'exécution.
  • Exécuter le pipeline de rendu de Remotion parallèlement à HyperFrames. C'est le motif d'interopérabilité d'exécution de PR #214 — une solution distincte 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 la supprime comme avertissement et traduit le reste. Voir references/escape-hatch.md.)

Comment évaluer votre propre traduction

Exécutez l'orchestrateur du corpus de test :

./assets/test-corpus/run.sh

Il exécute T1, T2, T3 (rendu + différence) et T4 (validation de l'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 checkout propre — et comme test 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
T1apparition progressive d'un seul élément0,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 d'analyse)8/8 réussin/a

Individual skills in this repo

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

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

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

Skills associés