Communitygithub.com

DigitalRavagers/Experiment

일반 웹사이트/URL을 캡처하여 HyperFrames 비디오(사이트 투어, 쇼케이스 또는 사이트 자체 비주얼을 활용한 소셜 클립)로 변환합니다. 헤드리스 크롬 스크린샷과 브랜드 에셋을 사용합니다.

Experiment란 무엇인가요?

이 스킬은 사용자가 제공한 웹사이트 URL을 기반으로 전문적인 비디오를 제작하는 AI 에이전트 워크플로우입니다. 포트폴리오, 블로그, 랜딩 페이지 등 일반 웹사이트를 쇼케이스하거나 소셜 미디어 클립으로 변환하는 데 최적화되어 있습니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 7단계의 협업 워크플로우를 통해 브랜드 아이덴티티 분석, 스토리보드 작성, 내레이션 생성, 컴포지션 빌드, 검증 및 전달까지 전 과정을 자동화합니다. 특히 '자율 모드'에서는 사용자 선호도 관련 결정을 AI가 대신하지만, 에셋 감사, 비트별 HTML 검증, 완료 조건 체크리스트와 같은 품질 검증 게이트는 필수적으로 수행됩니다. 이 스킬은 일반 사이트 비디오 제작에 특화되어 있으며, 제품 출시 프로모션이나 GitHub PR, 주제 설명자 등 다른 유형의 비디오 제작은 별도의 전용 스킬로 안내합니다.

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

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

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

문서

웹사이트를 하이퍼프레임으로

웹사이트를 캡처하여 전문적인 동영상으로 제작합니다.

0단계 전에 경로를 확인하세요. 이 스킬은 일반 웹사이트를 활용하여/로부터 동영상을 만듭니다. 사용자가 실제로 제품을 마케팅/런칭/홍보하는 경우(해당 URL에서 가져온 경우라도 "당사 사이트 홍보"를 포함) → /product-launch-video를 이용하세요. 사이트 없이 주제 설명 → /faceless-explainer; GitHub PR → /pr-to-video; 기존 동영상 파일 재편집/색상 재조정/순서 변경 → 범위를 벗어납니다. "동영상 만들어 줘"와 같은 모호한 요청이나 런칭인지 일반 사이트인지 확실하지 않은 경우? 먼저 /hyperframes를 읽으세요 (전체 라우팅 테이블 + § HyperFrames로 할 수 없는 일).

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

  • "이 웹사이트를 인스타그램용 15초 소셜 클립으로 바꿔줘"
  • "https://... 에서 30초짜리 사이트 투어/쇼케이스를 만들어줘"
  • "우리 홈페이지를 캡처해서 비주얼 그대로 동영상으로 만들어줘"

워크플로우는 7단계로 구성됩니다. 각 단계는 다음 단계로 넘어가기 위한 아티팩트를 생성합니다. 기본적으로 협업 방식이며, 💬로 표시된 게이트는 사용자에게 멈춰서 질문합니다. 사용자가 자율 모드("알아서 결정해 줘", "놀라게 해 줘")를 요청하면, 💬 사용자 선호도 게이트는 건너뜁니다. 이것이 어떻게 전파되는지는 step-2-brief.md를 참조하세요.

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

  • 자산 감사(3단계) – 콘택트 시트를 보고 각 자산에 대한 사용/건너뛰기 결정 이유 설명
  • 비트별 HTML 읽기(5단계) – 비트별로 구조화된 증거 블록 제공
  • DoD 체크리스트(6단계) – 애니메이션 맵, 경고별 WCAG 검증, 오디오/모션 재생 포함
  • 정직한 공개 섹션(6단계) – "내가 확인하지 않은 것"이 최종 요약에 반드시 포함되어야 함

"자동 모드가 행동 선호를 강조하니까 X는 건너뛰어도 되겠다"고 생각한다면, 그리고 그 X가 검증 게이트(선호도 질문이 아닌 경우)라면, 그 추론은 잘못된 것입니다. 행동 선호는 무엇을 만들지 결정하는 데 적용되는 것이지, 검증할지 여부를 결정하는 데 적용되는 것이 아닙니다.


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

참고: references/step-0-capture.md

사이트를 캡처한 다음 추출된 데이터를 읽어 브랜드와 제품을 이해합니다 – 무엇을 하는지, 누구를 위한 것인지, 어떤 어조로 말하는지, 어떤 분위기를 지니는지. 캡처된 자산은 나중에 사용할 브랜드 툴킷이지, 동영상을 구성하는 기본 요소는 아닙니다.

게이트: 사이트 요약 출력 – 자산/색상/폰트 목록보다 먼저 전략 우선(제품이 무엇을 하는지, 누구를 위한 것인지, 브랜드 어조)으로 작성.


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

참고: references/step-1-design.md

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

속도 옵션: 빠른 템포의 동영상(비트당 빌보드 스타일)의 경우 DESIGN.md는 색상 + 폰트 + Do/Don't 목록으로 구성된 50줄 요약본이면 충분하며, 300줄 분량의 문서는 필요 없습니다. 5단계의 하위 에이전트 프롬프트가 브랜드 값을 직접 붙여넣기 때문에 DESIGN.md의 깊이는 복잡한 구성에만 중요합니다.

게이트: 최소한 색상 팔레트, 폰트 선택, Do/Don't를 포함하는 DESIGN.md 파일이 존재하는 것.


2단계: 전략 및 메시징

참고: references/step-2-brief.md, references/capabilities.md (목차 스캔 – 필요할 때만 심층 섹션 참조)

시각적 요소나 자산을 논의하기 전에 사용자와 동영상이 전달해야 할 메시지에 대해 합의합니다. 사용자의 프롬프트를 분석하세요 – 아마 이미 동영상 유형과 스타일을 제시했을 것입니다. 빠진 것만 질문하세요: 이 동영상이 반드시 전달해야 할 한 가지, 내러티브 아크, 그리고 대상 청중.

게이트: 동영상 유형, 길이, 형식, 그리고 결정적으로 메시지와 내러티브 아크가 확정되어야 합니다. 이것들이 없으면 3단계에서 컨셉 중심의 스토리보드를 작성할 수 없습니다.


3단계: 스토리보드 + 스크립트 💬

참고: references/step-3-storyboard.md

스토리보드를 컨셉 중심으로 작성하세요: 메시지 → 내러티브 아크 → 아크를 구성하는 비트 → 비트별 기법 → 마지막에 브랜드 강조점 적용. 그런 다음 이에 맞는 내레이션 스크립트를 작성합니다. 비트별 요약과 함께 사용자에게 제시하고 승인할 때까지 반복합니다.

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


4단계: 음성 해설, 타이밍 및 자막 💬

참고: 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

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

게이트: 모든 compositions/beat-N.html 파일이 기본 에이전트에 의해 DESIGN.md 및 STORYBOARD.md와 비교하여 처음부터 끝까지 읽혀야 합니다. 비트별 체크리스트는 step-5-build.md에 있습니다.


6단계: 검증 및 전달

참고: references/step-6-validate.md

린트, 검증, 동영상 길이에 맞게 스케일링된 스냅샷 촬영(공식: 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 (인스타그램 스토리, TikTok)
  • 정사각형: 1080x1080 (인스타그램 피드)

참고 파일

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

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

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`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

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`.

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

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.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

관련 스킬