Communitygithub.com

Biznomad/agent-skills

Biznomad - Apple 수준의 비디오 스크롤 애니메이션 웹사이트 및 스크롤텔링 경험을 GSAP ScrollTrigger, Lenis 부드러운 스크롤, Canvas 이미지 시퀀스, ALL-I 인코딩 HTML5 비디오 스크러빙 및 고정 HUD 오버레이를 사용하여 구축합니다.

agent-skills란 무엇인가요?

이 스킬은 Apple, Stripe, Lusion 및 Awwwards Site-of-the-Day 수준의 고성능 비디오 스크롤 애니메이션 웹사이트를 구축하기 위한 완전한 아키텍처 패턴, FFmpeg 압축 파이프라인 및 프로덕션 JS/CSS 코드를 제공합니다. Canvas 이미지 시퀀스, ALL-I 인코딩 HTML5 비디오, WebGL 텍스처 셰이더의 세 가지 주요 렌더링 전략을 다루며, 각각의 장단점과 사용 사례를 설명합니다. 스킬은 Apple 스타일의 Canvas 시퀀스 구현(프리로더, Lenis 부드러운 스크롤, GSAP ScrollTrigger 동기화 및 반응형 HUD 오버레이 포함)을 위한 완전한 HTML/CSS/JS 보일러플레이트와 함께 제공되며, 비디오 스크러빙을 위한 대체 HTML5 비디오 접근 방식도 포함합니다. 또한 최고 수준의 품질을 위한 황금 규칙을 강조합니다: 프레임 내 키프레임(`-g 1`) 필수, 장치 픽셀 비율(DPR) 처리, 종횡비 커버 수학, Lenis 스크롤 보간 및 모바일 성능 폴백.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/video-scroll-website

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Biznomad - 비디오 스크롤 애니메이션 웹사이트 (Apple 수준의 스크롤텔링)

이 스킬은 Apple, Stripe, Lusion 및 Awwwards Site-of-the-Day 수준의 고성능 비디오 스크롤 애니메이션 웹사이트를 구축하기 위한 완전한 아키텍처 패턴, FFmpeg 압축 파이프라인 및 프로덕션 JS/CSS 코드를 제공합니다.


업계 연구 및 아키텍처 분석

스크롤 기반 비디오 경험을 구축할 때, 최고의 기술 및 디자인 에이전시는 세 가지 주요 렌더링 전략 중에서 선택합니다:

전략업계 참조최적 용도장점단점
Canvas 이미지 시퀀스Apple (MacBook, AirPods, iPhone)정밀 스크러빙, 제로 지연, 완벽한 프레임60–120fps 버터처럼 부드러움, 모든 모바일 GPU에서 작동프레임 사전 로딩 필요 (20–60MB 배열)
ALL-I 인코딩 HTML5 비디오Stripe, Nike, Tesla빠른 설정, 낮은 대역폭 단일 파일단일 MP4 다운로드, 빠른 초기화낮은 키프레임 거리 필요 (-g 1)
WebGL 텍스처 셰이더Lusion, Active Theory, Cuberto3D 깊이 왜곡, 액체 유리 효과초창의적, 조명 및 굴절 제어더 높은 GPU 오버헤드, 셰이더 복잡성

1. 비디오 준비 및 FFmpeg 인코딩 파이프라인

끊김 없는 즉각적인 부드러운 프레임 스크러빙을 달성하려면 비디오의 키프레임 거리가 반드시 1이어야 합니다 (모든 프레임이 Intra-frame / Keyframe임).

옵션 A: HTML5 비디오 스크러빙을 위한 비디오 준비 (ALL-I 인코딩)

초고속 스크러빙 MP4를 생성하려면 다음 FFmpeg 명령을 실행하세요:

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

옵션 B: Canvas 스크러빙을 위한 프레임 시퀀스 준비 (Apple 스타일)

압축된 1080p WebP 또는 JPEG 프레임을 추출합니다:

mkdir -p frames
ffmpeg -i input.mp4 -vf "scale=1920:1080" -q:v 85 frames/frame_%04d.jpg
# 또는 WebP (더 작은 파일 크기):
ffmpeg -i input.mp4 -vf "scale=1920:1080" -c:v libwebp -quality 85 frames/frame_%04d.webp

2. 기술 스택 구성

  • 부드러운 스크롤 엔진: @studio-freight/lenis 또는 Lenis (떨림 제거 및 모멘텀 스크롤 제공)
  • 애니메이션 드라이버: ScrollTrigger가 포함된 GSAP 3.12+
  • 렌더링 레이어: 2D 컨텍스트를 사용하는 <canvas> 또는 currentTime 동기화를 사용하는 <video>
  • 타이포그래피 및 HUD: 프레임 타임라인 트리거에 동기화된 유리 형태 고정 오버레이 카드

3. 프로덕션 아키텍처: Apple 스타일 Canvas 시퀀스 (권장)

다음은 프리로더, 부드러운 Lenis 스크롤 및 플로팅 스크롤텔링 복사 레이어가 포함된 Apple 스타일 Canvas 프레임 스크롤 시퀀스의 프로덕션 준비 구현입니다.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<title>Apple-Style Video Scroll Showcase</title>

<!-- Fonts & GSAP + Lenis CDNs -->
<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;
  }

  /* Preloader */
  #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;
  }

  /* Sticky Scroll Canvas Stage */
  .scroll-stage {
    position: relative;
    height: 400vh; /* 스크롤 상호작용 길이 결정 */
  }
  .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;
  }

  /* Floating Scrollytelling Overlay Panels */
  .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;
  }

  /* 개별 HUD 위치 */
  .hud-1 { top: 15%; left: 8%; }
  .hud-2 { top: 35%; right: 8%; }
  .hud-3 { bottom: 15%; left: 8%; }

  /* 종료 섹션 */
  .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>

<!-- 프리로더 -->
<div id="preloader">
  <div style="font-weight:700;font-size:14px;letter-spacing:0.1em">LOADING EXPERIENCE</div>
  <div class="loader-bar"><div class="loader-fill" id="loaderFill"></div></div>
</div>

<!-- 스크롤 비디오 컨테이너 -->
<div class="scroll-stage" id="scrollStage">
  <div class="sticky-viewport">
    <canvas id="scrollCanvas"></canvas>

    <!-- 스크롤텔링 HUD 오버레이 -->
    <div class="hud-overlay">
      <div class="hud-card hud-1" id="hud1">
        <div class="hud-eyebrow">01 / ARCHITECTURE</div>
        <h2 class="hud-title">Precision Engineered.</h2>
        <p class="hud-desc">Every frame calculated in real-time. Unmatched visual velocity and fluid responsiveness.</p>
      </div>

      <div class="hud-card hud-2" id="hud2">
        <div class="hud-eyebrow">02 / TELEMETRY</div>
        <h2 class="hud-title">Real-Time Data Flow.</h2>
        <p class="hud-desc">Sub-millisecond synchronization between user scroll input and canvas presentation.</p>
      </div>

      <div class="hud-card hud-3" id="hud3">
        <div class="hud-eyebrow">03 / PERFORMANCE</div>
        <h2 class="hud-title">120 FPS Mastery.</h2>
        <p class="hud-desc">GPU accelerated canvas rendering with zero frame drop or scroll stuttering.</p>
      </div>
    </div>
  </div>
</div>

<section class="outro-sec">
  <div>
    <h1 class="outro-title">Ready to Launch.</h1>
    <a href="#" class="btn-cta">EXPERIENCE THE FUTURE →</a>
  </div>
</section>

<script>
document.addEventListener('DOMContentLoaded', () => {
  // 1. 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);

  // Lenis를 GSAP ScrollTrigger와 동기화
  lenis.on('scroll', ScrollTrigger.update);
  gsap.ticker.add((time) => lenis.raf(time * 1000));
  gsap.ticker.lagSmoothing(0);

  // 2. Canvas 및 이미지 프리로더 설정
  const canvas = document.getElementById('scrollCanvas');
  const ctx = canvas.getContext('2d');
  const loaderFill = document.getElementById('loaderFill');
  const preloader = document.getElementById('preloader');

  const totalFrames = 120; // 추출된 프레임 수
  const images = [];
  const airbnb = { frame: 0 };

  // 프레임 URL 생성기 (상대 경로로 교체하세요)
  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);
  }

  // 고해상도 Retina 디스플레이 처리
  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;

    // Cover Fit 계산
    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);
  }

  // 초기 Canvas 크기 조정
  resizeCanvas();

  // 3. 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. 스크롤텔링 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. 대체 아키텍처: 직접 HTML5 비디오 스크러빙

Intra-frame 인코딩 (-g 1)을 사용하는 단일 압축 .mp4 비디오를 위한 프로젝트:

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

// 메타데이터가 로드되어 duration을 사용할 수 있도록 함
video.onloadedmetadata = function() {
  gsap.to(video, {
    currentTime: video.duration,
    ease: "none",
    scrollTrigger: {
      trigger: "#videoStage",
      start: "top top",
      end: "bottom bottom",
      scrub: 0.3
    }
  });
};

5. Apple 수준 품질을 위한 황금 규칙

  1. Intra-frame 키프레임 (-g 1): HTML5 비디오 스크러빙에 필수입니다. 그렇지 않으면 키프레임 탐색 간격에서 스크러빙이 끊깁니다.
  2. 장치 픽셀 비율 (DPR): 선명한 Retina 출력을 위해 항상 window.devicePixelRatio로 캔버스 해상도를 조정하세요.
  3. 종횡비 커버 계산: 캔버스 크기 조정 시 offsetX와 offsetY를 계산하여 프레임이 전체 영역을 채우는 object-fit cover를 유지하세요.
  4. Lenis 스크롤 보간: 부드러운 스크롤 관성(Lenis)을 절대 생략하지 마십시오. 순수 네이티브 휠 이벤트는 비디오 스크러빙을 저하시키는 개별 단계를 생성합니다.
  5. 모바일 성능 폴백: 저전력 모바일 장치(matchMedia('(prefers-reduced-motion: reduce)') 또는 낮은 대역폭)에서는 무거운 스크러빙 계산 대신 자동 비디오 재생 또는 정적 포스터 프레임을 제공하세요.

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.

관련 스킬