Communitygithub.com

1345AbhishekKumar/starter-supabase

일반 웹사이트/URL을 캡처하여 HyperFrames 비디오(사이트 투어, 쇼케이스 또는 사이트 자체 비주얼에서 추출한 소셜 클립)로 변환합니다. 헤드리스 Chrome 스크린샷 + 브랜드 에셋을 사용합니다. 포트폴리오/블로그/랜딩 페이지 쇼케이스 또는 사이트 기반 소셜 클립 의도에 사용하세요. NOT: 제품/SaaS 출시 또는 프로모션(→ /product-launch-video, URL에서도 마찬가지), 사이트 없는 주제 설명(→ /faceless-explainer), GitHub PR(→ /pr-to-video), 기존 비디오에 자막 추가(→ /embedded-captions), 짧고 내레이션 없는 페이지 하이라이트 모션 그래픽(→ /motion-graphics). 출시인지 일반 사이트인지 불확실하면, 질문 하나를 하거나 /hyperframes로 시작하세요.

starter-supabase란 무엇인가요?

이 기술은 사용자가 제공한 웹사이트 URL을 기반으로 전문적인 HyperFrames 비디오를 제작하는 방법을 정의합니다. 주로 포트폴리오, 블로그, 랜딩 페이지와 같은 일반 웹사이트를 쇼케이스하거나 소셜 미디어용 클립으로 변환하는 데 사용됩니다. 헤드리스 Chrome을 통해 사이트를 캡처한 후, 7단계 워크플로우(브랜드 파악, 디자인 전략, 스토리보드, 내레이션, 컴포지션 구축, 검증 및 전달)를 거쳐 결과물을 완성합니다. 이 기술은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자와 협업 모드 또는 자율 모드로 진행할 수 있습니다. 자율 모드에서도 품질 검증 게이트(에셋 감사, 비트별 HTML 검증, 완료 정의 체크리스트 등)는 건너뛰지 않고 반드시 수행해야 합니다. 각 단계는 이전 단계의 산출물에 의존하며, 주요 결정 시점에서는 사용자에게 확인을 요청합니다. 최종적으로 lint, validate 검사를 통과하고 Studio 프로젝트 URL을 제공하여 고품질 비디오를 전달하는 것이 목표입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/1345AbhishekKumar/starter-supabase/tree/HEAD/.agents/skills/website-to-video

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

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

문서

media-use: 오디오/이미지 소싱 전에 /media-use를 호출하여 HeyGen 카탈로그에서 BGM/SFX/이미지를 확인하세요. 먼저 --adopt를 실행하여 기존 에셋을 등록하세요. /media-use 기술을 참조하세요.

웹사이트를 HyperFrames로

웹사이트를 캡처하여 전문적인 비디오를 제작합니다.

0단계 전에 경로를 확인하세요. 이 기술은 일반 사이트에서 비디오를 제작합니다. 사용자가 진짜 제품을 마케팅/출시/프로모션하는 경우(이 URL에서도, "우리 사이트 홍보"라도) → /product-launch-video를 사용하세요. 사이트 없는 주제 설명 → /faceless-explainer; GitHub PR → /pr-to-video; 기존 비디오 파일 재편집/재색상화/재정렬 → 범위를 벗어납니다. "비디오 만들기"라는 모호한 요청, 또는 출시인지 일반 사이트인지 불확실한 경우? 먼저 /hyperframes를 읽으세요 (전체 라우팅 테이블 + § HyperFrames가 할 수 없는 것).

사용자들은 이렇게 말합니다:

  • "이 웹사이트를 Instagram용 15초 소셜 클립으로 만들어 줘"
  • "https://... 에서 30초 분량의 사이트 투어/쇼케이스를 만들어 줘"
  • "우리 홈페이지를 캡처해서 사이트 자체 비주얼로 비디오를 빌드해 줘"

워크플로우는 7단계로 구성됩니다. 각 단계는 다음 단계를 위한 아티팩트를 생성합니다. 기본적으로 협업 모드이며, 💬 표시는 사용자에게 확인을 요청하는 게이트입니다. 사용자가 자율 모드("알아서 결정해 줘", "깜짝 놀라게 해 줘")를 요청하면, 💬 사용자 선호 게이트는 건너뜁니다. 이에 대한 자세한 내용은 step-2-brief.md를 참조하세요.

자율 모드는 "모든 게이트를 건너뛰는 것"이 아닙니다. 자동 모드는 사용자 선호 질문(TTS 제공자, 음성, 색상 강조, 비트 수, 음악 유무, 자막 유무 — 에이전트가 사용자를 대신하여 결정)을 다룹니다. 품질 검증 게이트는 다루지 않습니다. 다음은 자동 모드에서도 건너뛸 수 없습니다:

  • 에셋 감사(3단계) — 접촉 시트를 보고 각 에셋에 대한 USE/SKIP을 정당화
  • 비트별 HTML 읽기(5단계) — 비트별 구조화된 증거 블록
  • DoD 체크리스트(6단계) — 애니메이션 맵, 경고별 WCAG 확인, 오디오/모션 재생 포함
  • 정직한 공개 섹션(6단계) — "내가 확인하지 않은 것"이 최종 요약에 반드시 포함되어야 함

"자동 모드가 행동 편향을 지향하므로 X를 건너뛰어야지"라고 판단한다면 — 그리고 X가 선호 질문이 아닌 검증 게이트라면 — 그 판단은 잘못된 것입니다. 행동 편향은 무엇을 만들지 결정하는 데 적용되는 것이지, _확인할지 여부를 결정하는 것_에는 적용되지 않습니다.


0단계: 사이트 캡처 및 브랜드 이해

읽기: references/step-0-capture.md

사이트를 캡처한 다음 추출된 데이터를 읽어 브랜드와 제품을 이해합니다 — 무엇을 하는지, 누구를 위한 것인지, 어떤 어조로 말하는지, 어떤 분위기를 가지고 있는지. 캡처된 에셋은 나중에 사용할 브랜드 도구 키트이지, 비디오를 만드는 빌딩 블록이 아닙니다.

브리핑 전에 로그인 상태를 표시하세요 — npx hyperframes auth status를 실행하고 출력을 그대로 전달하세요(의역하거나 다시 쓰지 마세요). 이 명령은 음성/BGM이 HeyGen 또는 로컬 엔진을 사용할지, 그리고 로그인되지 않은 경우 어떻게 로그인하는지 보고합니다. 로그인되지 않은 경우, 사용자가 선택할 때까지 중단하고 기다리세요 — 로그인하거나, 로컬 엔진으로 계속하려면 "go"/"offline"이라고 말하세요 — 브리핑이나 다른 것을 묻기 전에. 이것을 지나가는 메모가 아닌 실제 결정 지점으로 취급하세요. 선택 사항을 브리핑 질문에 포함시키지 말고, 키를 저장소별 .env에 쓰지 마세요. (자율 모드에서는 상태를 기록하고 오프라인으로 계속 진행하세요.) ../hyperframes-media → Preflight의 표준 지침을 참조하세요.

게이트: 사이트 요약이 출력됨 — 에셋/색상/글꼴 인벤토리 전에 전략 우선(제품이 무엇을 하는지, 누구를 위한 것인지, 브랜드 어조); 로그인 상태가 표시됨(로그인됨, 또는 오프라인 계속).


1단계: 브랜드 아이덴티티

읽기: references/step-1-design.md

DESIGN.md 작성 — 시각적 아이덴티티(색상, 타이포그래피, 컴포넌트 스타일, 레이아웃 원칙)를 다루는 브랜드 치트 시트. 정확한 계산된 값은 design-styles.json을 사용하세요.

속도 옵션: 빠른 템포의 비디오(비트당 빌보드)의 경우 DESIGN.md는 300줄 문서가 아닌 색상 + 글꼴 + do's/don'ts에 대한 50줄 요약일 수 있습니다. 5단계의 하위 에이전트 프롬프트는 브랜드 값을 직접 붙여넣으므로 DESIGN.md의 깊이는 복잡한 구성에만 중요합니다.

게이트: DESIGN.md가 존재함(모든 길이) — 최소한 색상 팔레트, 글꼴 선택, do's/don'ts 포함.


2단계: 전략 및 메시징

읽기: references/step-2-brief.md, references/capabilities.md (목차 스캔 — 필요한 경우에만 특정 섹션 심층 탐구)

시각 자료나 에셋을 이야기하기 전에 사용자와 비디오가 전달해야 할 메시지에 대해 조율하세요. 사용자의 프롬프트를 분석하세요 — 아마 이미 비디오 유형과 스타일을 제시했을 것입니다. 누락된 것만 물어보세요: 이 비디오가 반드시 전달해야 할 한 가지, 내러티브 아크, 그리고 대상 audience입니다.

게이트: 비디오 유형, 길이, 포맷, 그리고 중요한 것은 메시지와 내러티브 아크가 확정됨. 이것들 없이 3단계는 개념 우선 스토리보드를 작성할 수 없습니다.


3단계: 스토리보드 + 대본 💬

읽기: references/step-3-storyboard.md

스토리보드를 개념 우선으로 작성: 메시지 → 내러티브 아크 → 아크를 지원하는 비트 → 비트별 기법 → 마지막에 브랜드 악센트 적용. 그런 다음 이에 맞는 내레이션 대본을 작성합니다. 둘 다 비트별 요약과 함께 사용자에게 제시합니다. 사용자가 승인할 때까지 반복합니다.

게이트: STORYBOARD.md + SCRIPT.md가 존재하고 사용자가 계획을 승인함.


4단계: VO, 타이밍 + 자막 💬

읽기: references/step-4-vo.md

2단계에서 내레이션이 없다고 했으면 — 배경 음악에 대해 물어보고 5단계로 건너뜁니다. 그렇지 않으면: 사용자에게 어떤 TTS 제공자(HeyGen TTS, ElevenLabs, 또는 Kokoro)를 사용할지 물어보고, 오디오를 생성하고, 텍스트를 변환하고, 타임스탬프를 비트에 매핑합니다. 그런 다음 자막에 대해 물어봅니다.

게이트: (a) 내레이션이 요청되지 않았고 스토리보드에 수동 비트 타이밍이 있거나, 또는 (b) narration.wav + transcript.json이 존재하고 비트 타이밍이 실제 지속 시간으로 업데이트됨.


5단계: 컴포지션 빌드

읽기: hyperframes 기술 (로드 — 모든 규칙이 중요함) 읽기: references/step-5-build.md

스토리보드(3단계)에서 선택한 아키텍처와 템포에 따라 index.html 및 컴포지션을 빌드합니다. 하위 에이전트는 보고하기 전에 각 비트에 대해 hyperframes lint와 hyperframes snapshot을 실행합니다.

게이트: 모든 compositions/beat-N.html이 메인 에이전트에 의해 DESIGN.md 및 STORYBOARD.md에 대해 처음부터 끝까지 읽혀졌습니다. 비트별 체크리스트는 step-5-build.md에 있습니다.


6단계: 검증 및 전달

읽기: references/step-6-validate.md

Lint, 검증, 비디오 길이에 맞게 조정된 스냅샷 찍기(공식: max(비트 수 × 3, ceil(지속 시간_초 / 2))) 및 각각 검토. 전달하기 전에 문제를 수정하세요. localhost Studio 프로젝트 URL을 전달하세요 — 명시적인 사용자 요청이 있을 때만 MP4로 렌더링하세요. Studio URL은 인계 시에만 제공하세요 — 이것이 최종적이고 안정적인 미리보기입니다. 빌드 단계의 스냅샷은 헤드리스이므로 빌드 중간에 미리보기를 띄우지 마세요.

자랑스러워할 만한 것을 전달하세요. 인계하기 전에 스스로에게 물어보세요: 이걸 내 이름을 걸고 소셜 미디어에 올릴 수 있나요? 그렇지 않다면, 잘못된 부분을 수정하세요.

게이트: npx hyperframes lint 및 npx hyperframes validate가 오류 없이 통과하고, 최종 응답에 활성 Studio 프로젝트 URL이 포함됨.


빠른 참조

비디오 유형

비디오 유형별 일반적인 제약 조건 — 공식이 아닌 시작점으로 사용하세요. 비트 수는 대상 범위가 아닌 콘텐츠와 내레이션에 따라 결정되어야 합니다.

유형일반적인 길이길이 결정 요인내레이션
소셜 광고(IG/TikTok)10–15초플랫폼 제한선택 사항
제품 데모30–60초대본 길이전체 내레이션
기능 발표15–30초기능 복잡도전체 내레이션
브랜드 릴20–45초음악 트랙선택 사항, 음악 중심
출시 티저10–20초후크 에너지최소한

비트 수는 의도적으로 이 표에 없습니다 — "소셜 광고 = 3-4비트"가 아닌 스토리보드에서 나와야 합니다. 복잡한 제품의 소셜 광고는 5개의 잘 배치된 비트가 필요할 수 있습니다. 하나의 강력한 시각적 테제를 가진 브랜드 릴은 3개의 비트가 필요할 수 있습니다.

포맷

  • 가로: 1920x1080 (기본값)
  • 세로: 1080x1920 (Instagram Stories, TikTok)
  • 정사각형: 1080x1080 (Instagram 피드)

참조 파일

파일읽어야 할 시기
step-0-capture.md0단계 — 캡처, 브랜드와 제품 이해, 전략 우선 사이트 요약 작성
step-1-design.md1단계 — DESIGN.md 브랜드 치트 시트 작성 (5개 섹션, 250-350줄; 빌보드 스타일 소셜 광고용 50줄 고속 경로)
step-2-brief.md2단계 — 메시지, 내러티브 아크, 대상 audience에 대해 사용자와 조율
capabilities.md2단계 및 5단계 — HyperFrames가 할 수 있는 전체 인벤토리 (24개 섹션). 브리핑 중에 TOC를 스캔하고, 빌드 중에 특정 섹션을 심층 탐구
step-3-storyboard.md3단계 — 스토리보드 + 대본 (결합) 사용자 검토 게이트 포함
step-4-vo.md4단계 — TTS 제공자 선택, 생성, 타이밍
step-5-build.md5단계 — index.html + 컴포지션 빌드
step-6-validate.md6단계 — lint, 검증, 스냅샷 (비디오 길이에 맞게 조정), 미리보기
techniques.md3단계 및 5단계 — 코드 패턴이 포함된 13가지 기본 애니메이션 기법 (적응하여 사용하고, 복사-붙여넣기하지 마세요)
html-in-canvas-patterns.md5단계 — HTML-in-Canvas 효과에 대한 완전한 코드 패턴 (hyperframes 기술에 있음)

Individual skills in this repo

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

1345AbhishekKumar/starter-supabase

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

1345AbhishekKumar/starter-supabase

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

1345AbhishekKumar/starter-supabase

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

1345AbhishekKumar/starter-supabase

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

1345AbhishekKumar/starter-supabase

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

1345AbhishekKumar/starter-supabase

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

1345AbhishekKumar/starter-supabase

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

1345AbhishekKumar/starter-supabase

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

1345AbhishekKumar/starter-supabase

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

1345AbhishekKumar/starter-supabase

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

1345AbhishekKumar/starter-supabase

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

1345AbhishekKumar/starter-supabase

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /website-to-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

1345AbhishekKumar/starter-supabase

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

관련 스킬