Communitygithub.com

Biznomad/agent-skills

Créez des compositions vidéo, animations, cartes-titres, incrustations, légendes, voix off, visuels réactifs à l'audio et transitions de scènes en HyperFrames HTML. À utiliser pour tout contenu vidéo basé sur HTML, ajouter des légendes synchronisées, générer une narration par synthèse vocale, créer des animations réactives à l'audio, ou ajouter des transitions entre scènes.

Qu'est-ce que agent-skills ?

Cette compétence permet à un agent IA de générer des compositions vidéo complètes en HTML via le framework HyperFrames, en traitant l'intégralité du pipeline de production : de la découverte du brief à la sortie rendue. Elle couvre la création de cartes-titres, animations, incrustations, légendes synchronisées à l'audio, voix off par synthèse vocale (TTS), visuels réactifs à l'audio (synchronisation sur le rythme, effets de lueur, pulsations), animations de texte (surlignages, cercles dessinés à la main, lignes d'éclatement, gribouillis, esquisses) et transitions entre scènes (fondus, volets, révélations, transitions shader). Elle est conçue pour être utilisée avec des agents comme Claude Code, Cursor ou Codex, et fonctionne sur tout système supportant Node.js. La compétence suit un flux de travail structuré en plusieurs étapes : d'abord établir un système de design (basé sur un fichier design.md ou une sélection de style), puis élargir la demande utilisateur via un prompt expansé, planifier la composition (structure, rythme, timing, disposition, animation), et enfin implémenter en respectant des règles strictes de disposition avant animation pour éviter les chevauchements. Elle s'appuie fortement sur des fichiers de référence (design.md, house-style.md, visual-styles.md, prompt-expansion.md, beat-direction.md, motion-principles.md) pour garantir la cohérence et la qualité.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/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 framework gère la visibilité des clips, la lecture des médias et la synchronisation de la timeline.

Approche

Découverte (demandes exploratoires uniquement)

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

  • Public — qui regarde ceci ? Développeurs ? Dirigeants ? Consommateurs généraux ?
  • Plateforme — où est-ce diffusé ? Réseaux sociaux (15s), page d'accueil du site, démo produit, interne ?
  • Priorité — qu'est-ce qui compte le plus ? Qualité du mouvement ? Précision du contenu ? Fidélité à la marque ? Rapidité ?
  • Variantes — l'utilisateur veut-il des options ou un seul meilleur résultat ?

Pour les demandes spécifiques (« ajoute une carte-titre », « corrige le timing de la scène 3 »), sautez la découverte.

Pour les demandes exploratoires, envisagez de proposer 2 à 3 variantes qui diffèrent significativement — pas seulement des changements de couleurs, mais des rythmes, niveaux d'énergie ou approches structurelles différents. Une variante sûre/attendue, une ambitieuse. Ne rendez pas cela obligatoire — c'est un outil disponible quand c'est approprié.

Étape 1 : Système de design

Si design.md ou DESIGN.md existe dans le projet, lisez-le d'abord (vérifiez les deux cas — ce sont des fichiers distincts 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 ou ne substituez pas de polices. N'importe quel format fonctionne (frontmatter YAML, prose, tableaux — extrayez simplement les valeurs).

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

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

  1. L'utilisateur a nommé un style ou une ambiance ? → Lisez visual-styles.md pour les 8 préréglages nommés. Choisissez la correspondance la plus proche.
  2. Veut parcourir les options visuellement ? → Lancez le sélecteur de design : lisez references/design-picker.md pour le flux de travail complet. Cela sert une page de sélection visuelle. L'utilisateur configure l'ambiance, 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. Veut ignorer et aller vite ? → Demandez : ambiance, clair ou sombre, des couleurs/polices de marque ? Ensuite choisissez 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 de house-style.md. Utilisez les couleurs de la marque à une échelle adaptée à la vidéo — pas à l'opacité d'une UI web.

Étape 2 : Expansion du prompt

Toujours exécuter sur chaque composition (sauf pour 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 tout 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 du HTML, réfléchissez à un haut niveau :

  1. Quoi — que doit ressentir le spectateur ? Identifiez l'arc narratif, les moments clés et les battements émotionnels.
  2. Structure — combien de compositions, lesquelles sont des sous-compositions vs en ligne, quelles pistes transportent quoi (vidéo, audio, incrustations, légendes).
  3. Rythme — déclarez votre rythme de scène avant l'implémentation. Quelles scènes sont des impacts rapides, lesquelles sont des pauses, où se situent les shaders, où le pic d'énergie. Nommez le motif : rapide-rapide-LENT-rapide-SHADER-pause. Lisez references/beat-direction.md pour les modèles de rythme.
  4. Timing — quels clips déterminent la durée, où se situent les transitions, quel est le rythme.
  5. Disposition — construisez d'abord l'état final. Voir « Disposition avant animation » ci-dessous.
  6. Animation — ajoutez ensuite le 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 + légendes ». 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 en train de sortir. Écrivez ceci d'abord en HTML+CSS statique. Pas de GSAP pour l'instant.

Pourquoi c'est important : Si vous positionnez les éléments à leur état de départ animé (hors écran, échelle à 0, opacité 0) et les animez vers où vous pensez qu'ils doivent atterrir, vous devinez la disposition finale. Les chevauchements sont invisibles jusqu'à ce que la vidéo soit rendue. En construisant l'état final d'abord, vous pouvez voir et corriger les problèmes de disposition avant d'ajouter du 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 disposition 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 en position absolue débordent lorsque le contenu est plus grand que l'espace restant. Réservez position: absolute pour les éléments décoratifs uniquement.
  3. Ajoutez les entrées avec gsap.from() — animez DE hors écran/invisible VERS la position CSS. La position CSS est la vérité de base ; l'interpolation décrit le voyage 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 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 toute taille de scène (1920x1080, 1080x1920, etc.).
   Le padding positionne le contenu. Flex + gap gère l'espacement. */

ERREUR — 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);

Quand les éléments partagent un espace dans le temps

Si l'élément A sort avant que l'é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 à cause d'une erreur de timing.

Ce qui est considéré comme un chevauchement intentionnel

Les effets en couches (lueur derrière le texte, éléments d'ombre, motifs d'arrière-plan) et les conceptions empilées en z (piles de cartes, couches de profondeur) sont intentionnels. L'étape de disposition sert à détecter les chevauchements non intentionnels — deux titres atterrissant l'un sur l'autre, une statistique couvrant une étiquette, un 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 sur la durée du média
data-track-indexOuiEntier. Les clips d'une même piste ne peuvent pas se chevaucher
data-media-startNonDécalage de coupe dans la source (secondes)
data-volumeNon0-1 (par défaut 1)

data-track-index n'affecte pas le calque visuel — utilisez le CSS z-index.

Clips de composition

AttributRequisValeurs
data-composition-idOuiID de composition unique
data-startOuiHeure de début (composition racine : utilisez "0")
data-durationOuiPrédomine 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 de variables par instance sur un hôte de sous-comp

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 la div data-composition-id directement dans <body>. Utiliser <template> sur un fichier autonome cache tout contenu du navigateur et casse 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 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, légendes — sans modifier le HTML source.

Motif en trois étapes :

  1. Déclarez les variables sur la racine <html> de la composition avec data-composition-variables. Chaque entrée a besoin de id, type (un de string, number, color, boolean, enum), label et default. Les entrées enum ont également besoin de options: [{value, label}, ...].
  2. Lisez les valeurs résolues à l'intérieur du script de la composition avec window.__hyperframes.getVariables(). Retourne 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-comps).
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Title","default":"Hello"},
  {"id":"theme","type":"enum","label":"Theme","default":"light","options":[
    {"value":"light","label":"Light"},
    {"value":"dark","label":"Dark"}
  ]}
]'
>
  <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

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

# Ou depuis 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-comps chargées via data-composition-src. Chaque élément hôte passe 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"

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

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

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.

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