Communitygithub.com

Biznomad/agent-skills

Biznomad - Construisez des sites web animés par défilement de qualité Apple et des expériences scrollytelling utilisant GSAP ScrollTrigger, Lenis smooth scroll, des séquences d'images Canvas, le scrubbing vidéo HTML5 encodé en ALL-I et des superpositions HUD fixes.

Qu'est-ce que agent-skills ?

Cette compétence fournit des modèles architecturaux complets, des pipelines de compression FFmpeg et du code JS/CSS prêt pour la production pour créer des sites web animés par défilement vidéo haute performance, conformes aux normes Apple, Stripe, Lusion et Awwwards Site-of-the-Day. Elle détaille trois stratégies de rendu principales : les séquences d'images Canvas (de type Apple), la vidéo HTML5 encodée en ALL-I (de type Stripe) et les shaders WebGL (de type Lusion), chacune avec ses avantages et inconvénients en termes de précision, bande passante et charge GPU. La compétence est conçue pour les développeurs utilisant des agents d'IA comme Claude Code, Cursor ou Codex, et propose des pipelines de préparation vidéo concrets (commandes FFmpeg pour le scrub à image clé unique) ainsi qu'une implémentation complète de page HTML prête à l'emploi. Elle couvre des techniques avancées comme la gestion du ratio pixel de l'appareil (DPR) pour les écrans Retina, le calcul du ratio d'aspect pour le remplissage parfait des images, et le déclenchement chronométré de superpositions HUD semi-transparentes (glassmorphisme) synchronisées avec le défilement.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-scroll-website

Demander à votre IA préférée

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

Documentation

Biznomad - Sites Web Animés par Défilement Vidéo (Scrollytelling de Qualité Apple)

Cette compétence fournit des modèles architecturaux complets, des pipelines de compression FFmpeg et du code JS/CSS prêt pour la production pour créer des sites web animés par défilement vidéo haute performance, conformes aux normes Apple, Stripe, Lusion et Awwwards Site-of-the-Day.


Recherche Sectorielle & Décomposition Architecturale

Lors de la construction d'expériences vidéo pilotées par le défilement, les grandes entreprises technologiques et agences de design sélectionnent parmi trois stratégies de rendu principales :

StratégieRéférence SectorielleMeilleure PourAvantagesInconvénients
Séquence d'Images CanvasApple (MacBook, AirPods, iPhone)Scrub de précision, zéro latence, perfection d'image60–120fps ultra-fluide, fonctionne sur tous les GPU mobilesNécessite un préchargement des images (tableau de 20–60 Mo)
Vidéo HTML5 Encodée ALL-IStripe, Nike, TeslaConfiguration rapide, faible bande passante, fichier uniqueUn seul téléchargement MP4, initialisation rapideNécessite une faible distance entre images clés (-g 1)
Shader Texture WebGLLusion, Active Theory, CubertoDistorsion 3D, effets de verre liquideUltra-créatif, contrôle de l'éclairage et de la réfractionCharge GPU plus élevée, complexité des shaders

1. Préparation Vidéo & Pipeline d'Encodage FFmpeg

Pour obtenir un scrub d'image instantané et fluide sans à-coups, la vidéo DOIT être encodée avec une distance entre images clés de 1 (chaque image est une Intra-image / Image clé).

Option A : Préparer la Vidéo pour le Scrub Vidéo HTML5 (Encodage ALL-I)

Exécutez cette commande FFmpeg pour générer un MP4 à scrub ultra-rapide :

ffmpeg -i input.mp4 -vf "scale=1920:1080:force_original_aspect_ratio=decrease,pad=1920:1080:(ow-iw)/2:(oh-ih)/2" -c:v libx264 -preset slow -crf 18 -g 1 -keyint_min 1 -an -movflags +faststart output_scrub.mp4

Option B : Préparer la Séquence d'Images pour le Scrub Canvas (Style Apple)

Extrayez des images WebP ou JPEG compressées en 1080p :

mkdir -p frames
ffmpeg -i input.mp4 -vf "scale=1920:1080" -q:v 85 frames/frame_%04d.jpg
# Ou pour WebP (taille de fichier plus petite) :
ffmpeg -i input.mp4 -vf "scale=1920:1080" -c:v libwebp -quality 85 frames/frame_%04d.webp

2. Configuration de la Pile Technique

  • Moteur de Défilement Fluide : @studio-freight/lenis ou Lenis (élimine les secousses et procure un défilement inertiel)
  • Moteur d'Animation : GSAP 3.12+ avec ScrollTrigger
  • Couche de Rendu : <canvas> avec contexte 2D ou <video> avec synchronisation currentTime
  • Typographie & HUD : Cartes de superposition fixes à effet de verre dépoli synchronisées avec les déclencheurs de la timeline d'images

3. Architecture de Production : Séquence Canvas Style Apple (Recommandée)

Voici l'implémentation prête pour la production d'une séquence de défilement d'images Canvas de style Apple avec préchargeur, défilement fluide Lenis et calques de copie flottants scrollytelling.

<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<title>Démonstration de Défilement Vidéo Style Apple</title>

<!-- Polices & CDNs GSAP + Lenis -->
<link rel="preconnect" href="https://fonts.googleapis.com"/>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;600;800;900&family=JetBrains+Mono:wght@500;700&display=swap" rel="stylesheet"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/lenis.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>

<style>
  :root {
    --bg: #000000;
    --paper: #f5f5f7;
    --dim: #86868b;
    --accent: #2997ff;
    --accent-glow: rgba(41, 151, 255, 0.35);
    --panel: rgba(22, 22, 23, 0.75);
    --line: rgba(255, 255, 255, 0.12);
  }

  * { box-sizing: border-box; margin: 0; padding: 0; }
  body {
    background: var(--bg);
    color: var(--paper);
    font-family: "Inter", system-ui, -apple-system, sans-serif;
    overflow-x: hidden;
    -webkit-font-smoothing: antialiased;
  }

  /* Préchargeur */
  #preloader {
    position: fixed;
    inset: 0;
    z-index: 999;
    background: #000;
    display: flex;
    flex-direction: column;
    align-items: center;
    justify-content: center;
    gap: 16px;
    transition: opacity 0.6s ease, visibility 0.6s ease;
  }
  #preloader.done { opacity: 0; visibility: hidden; }
  .loader-bar {
    width: 200px;
    height: 3px;
    background: rgba(255, 255, 255, 0.15);
    border-radius: 999px;
    overflow: hidden;
  }
  .loader-fill {
    height: 100%;
    width: 0%;
    background: var(--accent);
    transition: width 0.1s linear;
  }

  /* Scène de Défilement Collant */
  .scroll-stage {
    position: relative;
    height: 400vh; /* Détermine la longueur de l'interaction de défilement */
  }
  .sticky-viewport {
    position: sticky;
    top: 0;
    width: 100vw;
    height: 100vh;
    overflow: hidden;
    display: flex;
    align-items: center;
    justify-content: center;
  }
  canvas#scrollCanvas {
    width: 100%;
    height: 100%;
    object-fit: cover;
    display: block;
  }

  /* Panneaux de Superposition Scrollytelling Flottants */
  .hud-overlay {
    position: absolute;
    inset: 0;
    pointer-events: none;
    z-index: 10;
  }
  .hud-card {
    position: absolute;
    max-width: 460px;
    background: var(--panel);
    backdrop-filter: blur(20px);
    -webkit-backdrop-filter: blur(20px);
    border: 1px solid var(--line);
    border-radius: 20px;
    padding: 32px;
    opacity: 0;
    transform: translateY(30px);
    transition: opacity 0.5s ease, transform 0.5s ease;
  }
  .hud-card.active {
    opacity: 1;
    transform: translateY(0);
  }
  .hud-eyebrow {
    font-family: "JetBrains Mono", monospace;
    color: var(--accent);
    font-size: 12px;
    letter-spacing: 0.15em;
    text-transform: uppercase;
    font-weight: 700;
    margin-bottom: 8px;
  }
  .hud-title {
    font-size: 32px;
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.1;
    margin-bottom: 12px;
  }
  .hud-desc {
    color: var(--dim);
    font-size: 15px;
    line-height: 1.6;
  }

  /* Positions Individuelles HUD */
  .hud-1 { top: 15%; left: 8%; }
  .hud-2 { top: 35%; right: 8%; }
  .hud-3 { bottom: 15%; left: 8%; }

  /* Section de Fin */
  .outro-sec {
    min-height: 100vh;
    display: flex;
    align-items: center;
    justify-content: center;
    text-align: center;
    background: #08080a;
    border-top: 1px solid var(--line);
    padding: 80px 24px;
  }
  .outro-title {
    font-size: clamp(40px, 6vw, 84px);
    font-weight: 900;
    letter-spacing: -0.04em;
    margin-bottom: 24px;
  }
  .btn-cta {
    display: inline-block;
    background: var(--accent);
    color: #fff;
    font-weight: 700;
    padding: 16px 36px;
    border-radius: 999px;
    text-decoration: none;
    box-shadow: 0 10px 30px var(--accent-glow);
    transition: transform 0.2s;
  }
  .btn-cta:hover { transform: scale(1.05); }
</style>
</head>
<body>

<!-- Préchargeur -->
<div id="preloader">
  <div style="font-weight:700;font-size:14px;letter-spacing:0.1em">CHARGEMENT DE L'EXPÉRIENCE</div>
  <div class="loader-bar"><div class="loader-fill" id="loaderFill"></div></div>
</div>

<!-- Conteneur de Défilement Vidéo -->
<div class="scroll-stage" id="scrollStage">
  <div class="sticky-viewport">
    <canvas id="scrollCanvas"></canvas>

    <!-- Superpositions Scrollytelling HUD -->
    <div class="hud-overlay">
      <div class="hud-card hud-1" id="hud1">
        <div class="hud-eyebrow">01 / ARCHITECTURE</div>
        <h2 class="hud-title">Conçu avec Précision.</h2>
        <p class="hud-desc">Chaque image calculée en temps réel. Vélocité visuelle et réactivité fluide inégalées.</p>
      </div>

      <div class="hud-card hud-2" id="hud2">
        <div class="hud-eyebrow">02 / TÉLÉMÉTRIE</div>
        <h2 class="hud-title">Flux de Données en Temps Réel.</h2>
        <p class="hud-desc">Synchronisation sub-milliseconde entre l'entrée de défilement de l'utilisateur et la présentation sur le canvas.</p>
      </div>

      <div class="hud-card hud-3" id="hud3">
        <div class="hud-eyebrow">03 / PERFORMANCE</div>
        <h2 class="hud-title">Maîtrise du 120 FPS.</h2>
        <p class="hud-desc">Rendu canvas accéléré par GPU sans perte d'image ni à-coups de défilement.</p>
      </div>
    </div>
  </div>
</div>

<section class="outro-sec">
  <div>
    <h1 class="outro-title">Prêt à Lancer.</h1>
    <a href="#" class="btn-cta">DÉCOUVRIR LE FUTUR →</a>
  </div>
</section>

<script>
document.addEventListener('DOMContentLoaded', () => {
  // 1. Initialisation du Défilement Fluide Lenis
  const lenis = new Lenis({
    duration: 1.2,
    easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)),
    smoothWheel: true
  });

  function raf(time) {
    lenis.raf(time);
    requestAnimationFrame(raf);
  }
  requestAnimationFrame(raf);

  // Synchronisation Lenis avec GSAP ScrollTrigger
  lenis.on('scroll', ScrollTrigger.update);
  gsap.ticker.add((time) => lenis.raf(time * 1000));
  gsap.ticker.lagSmoothing(0);

  // 2. Configuration du Canvas & Préchargeur d'Images
  const canvas = document.getElementById('scrollCanvas');
  const ctx = canvas.getContext('2d');
  const loaderFill = document.getElementById('loaderFill');
  const preloader = document.getElementById('preloader');

  const totalFrames = 120; // Nombre d'images extraites
  const images = [];
  const airbnb = { frame: 0 };

  // Générateur d'URL d'image (Remplacez par votre chemin relatif)
  const currentFrame = (index) => `./frames/frame_${(index + 1).toString().padStart(4, '0')}.jpg`;

  let loadedCount = 0;
  for (let i = 0; i < totalFrames; i++) {
    const img = new Image();
    img.src = currentFrame(i);
    img.onload = () => {
      loadedCount++;
      loaderFill.style.width = `${(loadedCount / totalFrames) * 100}%`;
      if (loadedCount === totalFrames) {
        preloader.classList.add('done');
        renderCanvas();
      }
    };
    images.push(img);
  }

  // Gestion des écrans Retina Haute-DPI
  function resizeCanvas() {
    const dpr = window.devicePixelRatio || 1;
    canvas.width = window.innerWidth * dpr;
    canvas.height = window.innerHeight * dpr;
    ctx.scale(dpr, dpr);
    renderCanvas();
  }
  window.addEventListener('resize', resizeCanvas);

  function renderCanvas() {
    if (!images[airbnb.frame]) return;
    const img = images[airbnb.frame];
    const w = window.innerWidth;
    const h = window.innerHeight;

    // Calcul du Remplissage Parfait
    const imgRatio = img.width / img.height;
    const canvasRatio = w / h;
    let drawW, drawH, offsetX, offsetY;

    if (canvasRatio > imgRatio) {
      drawW = w;
      drawH = w / imgRatio;
      offsetX = 0;
      offsetY = (h - drawH) / 2;
    } else {
      drawW = h * imgRatio;
      drawH = h;
      offsetX = (w - drawW) / 2;
      offsetY = 0;
    }

    ctx.clearRect(0, 0, w, h);
    ctx.drawImage(img, offsetX, offsetY, drawW, drawH);
  }

  // Redimensionnement Initial du Canvas
  resizeCanvas();

  // 3. Séquence GSAP ScrollTrigger
  gsap.to(airbnb, {
    frame: totalFrames - 1,
    snap: "frame",
    ease: "none",
    scrollTrigger: {
      trigger: "#scrollStage",
      start: "top top",
      end: "bottom bottom",
      scrub: 0.5,
      onUpdate: () => renderCanvas()
    }
  });

  // 4. Déclencheurs des Superpositions Scrollytelling HUD
  function setupHudTrigger(id, startPct, endPct) {
    ScrollTrigger.create({
      trigger: "#scrollStage",
      start: `${startPct}% top`,
      end: `${endPct}% top`,
      onEnter: () => document.getElementById(id).classList.add('active'),
      onLeave: () => document.getElementById(id).classList.remove('active'),
      onEnterBack: () => document.getElementById(id).classList.add('active'),
      onLeaveBack: () => document.getElementById(id).classList.remove('active')
    });
  }

  setupHudTrigger('hud1', 10, 30);
  setupHudTrigger('hud2', 35, 60);
  setupHudTrigger('hud3', 65, 90);
});
</script>

</body>
</html>

4. Architecture Alternative : Scrub Vidéo HTML5 Direct

Pour les projets utilisant une seule vidéo .mp4 compressée avec encodage Intra-image (-g 1) :

const video = document.getElementById('scrubVideo');
video.pause();

// Assurez-vous que les métadonnées sont chargées pour la durée
video.onloadedmetadata = function() {
  gsap.to(video, {
    currentTime: video.duration,
    ease: "none",
    scrollTrigger: {
      trigger: "#videoStage",
      start: "top top",
      end: "bottom bottom",
      scrub: 0.3
    }
  });
};

5. Règles d'Or pour une Qualité de Niveau Apple

  1. Images Clés Intra-images (-g 1) : Obligatoire pour le scrub vidéo HTML5, sinon le scrub saccade aux intervalles de recherche d'images clés.
  2. Ratio de Pixels de l'Appareil (DPR) : Toujours mettre à l'échelle la résolution du canvas par window.devicePixelRatio pour une sortie Retina d'une netteté parfaite.
  3. Calcul du Ratio d'Aspect : Calculez offsetX et offsetY lors du redimensionnement du canvas pour que les images conservent un remplissage parfait (object-fit cover).
  4. Interpolation de Défilement Lenis : N'omettez jamais l'inertie de défilement fluide (Lenis). Les événements natifs de roue créent des étapes discrètes qui dégradent le scrubbing vidéo.
  5. Repli de Performance Mobile : Sur les appareils mobiles de faible puissance (matchMedia('(prefers-reduced-motion: reduce)') ou faible bande passante), proposez une lecture automatique de la vidéo ou des images statiques de substitution au lieu de calculs de scrubbing lourds.

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

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.

Skills associés