Communitygithub.com

sergekostenchuk/ui-ux-agent-skill-system

웹사이트를 캡처하여 HyperFrames 동영상으로 변환합니다. 사용자가 URL을 제공하거나 '이 사이트를 캡처해줘', '동영상으로 만들어줘', '내 사이트로 홍보 영상을 만들어줘'와 같이 요청할 때 사용합니다.

ui-ux-agent-skill-system란 무엇인가요?

이 스킬은 사용자가 제공한 웹사이트 URL을 캡처하여 HyperFrames 기반의 전문 동영상으로 제작하는 7단계 워크플로우를 제공합니다. 소셜 광고, 제품 투어, 런칭 티저 등 다양한 동영상 유형을 지원하며, 각 단계는 명확한 게이트(완료 조건)를 통해 다음 단계로 진행됩니다. Claude Code와 같은 AI 에이전트 환경에서 실행되며, 캡처 단계에서 추출한 사이트 데이터를 바탕으로 DESIGN.md, SCRIPT.md, STORYBOARD.md를 순차적으로 작성합니다. 이후 TTS 음성 생성, 타임스탬프 매핑, 컴포지션 빌드 및 자체 검토, 최종 검증(lint, validate)을 거쳐 완성된 동영상 산출물을 제공합니다. 각 단계별로 상세한 참조 파일(references 폴더 내 마크다운 문서)이 제공되어 AI 에이전트가 엄격한 순서와 규칙을 따라 작업을 수행할 수 있도록 안내합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system/tree/HEAD/core/skills/website-to-hyperframes

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

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

문서

웹사이트 to HyperFrames

웹사이트를 캡처한 후 전문 동영상으로 제작합니다.

사용자는 다음과 같이 말합니다:

  • "https://...를 캡처해서 25초짜리 제품 런칭 동영상을 만들어줘"
  • "이 웹사이트를 15초짜리 Instagram 소셜 광고로 바꿔줘"
  • "https://...에서 30초짜리 제품 투어를 만들어줘"

워크플로우는 7단계로 이루어져 있습니다. 각 단계는 다음 단계를 위한 아티팩트를 생성합니다.


1단계: 캡처 및 이해

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

캡처를 실행하고, 추출된 데이터를 읽은 후, 기록 후 잊기(write-down-and-forget) 방법을 사용하여 작업 요약을 만듭니다.

게이트: 사이트 요약(이름, 주요 색상, 폰트, 주요 에셋, 한 문장 분위기)을 출력합니다.


2단계: DESIGN.md 작성

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

캡처된 웹사이트에 대한 간단한 브랜드 참조 문서를 작성합니다. 6개 섹션, 약 90줄. 이는 치트 시트이며, 창의적인 계획은 4단계에서 수립합니다.

게이트: DESIGN.md가 프로젝트 디렉토리에 존재합니다.


3단계: SCRIPT 작성

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

내레이션 스크립트를 작성합니다. 이야기의 뼈대입니다. 장면 지속 시간은 추측이 아닌 내레이션에서 결정됩니다.

게이트: SCRIPT.md가 프로젝트 디렉토리에 존재합니다.


4단계: STORYBOARD 작성

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

비트(beat)별 창의적 방향을 작성합니다: 분위기, 카메라, 애니메이션, 전환, 에셋, 깊이 레이어, SFX. 이는 창의적인 나침반 역할을 하며, 엔지니어가 각 컴포지션을 구축할 때 따르는 문서입니다.

게이트: STORYBOARD.md가 비트별 방향과 에셋 감사 테이블과 함께 존재합니다.


5단계: VO 생성 및 타이밍 매핑

참고: references/step-5-vo.md

TTS 오디오를 생성하고, 단어 수준 타임스탬프를 위한 텍스트를 변환한 후, 타임스탬프를 비트에 매핑합니다. STORYBOARD.md를 실제 지속 시간으로 업데이트합니다.

게이트: narration.wav (또는 .mp3) + transcript.json이 존재합니다. STORYBOARD.md의 비트 타이밍이 업데이트됩니다.


6단계: 컴포지션 빌드

참고: /hyperframes 스킬 (모든 규칙이 중요하므로 호출하세요) 참고: references/step-6-build.md

스토리보드에 따라 각 컴포지션을 빌드합니다. 각각 완료 후: 레이아웃, 에셋 배치, 애니메이션 품질에 대한 자체 검토를 수행합니다.

게이트: 모든 컴포지션이 자체 검토되었습니다. 겹치는 요소, 잘못 배치된 에셋, 모션이 없는 정적 이미지가 없습니다.


7단계: 검증 및 전달

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

린트, 검증, 미리보기를 수행합니다. 다중 세션 연속성을 위해 HANDOFF.md를 생성합니다.

게이트: npx hyperframes lint 및 npx hyperframes validate가 오류 없이 통과합니다.


빠른 참조

동영상 유형

유형지속 시간비트내레이션
소셜 광고 (IG/TikTok)10-15초3-4선택적 후크 문장
제품 데모30-60초5-8전체 내레이션
기능 발표15-30초3-5전체 내레이션
브랜드 릴20-45초4-6선택적, 음악 중심
런칭 티저10-20초2-4최소한, 고에너지

포맷

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

참조 파일

파일읽을 시기
step-1-capture.md1단계 — 캡처된 데이터 읽기
step-2-design.md2단계 — DESIGN.md 작성
step-3-script.md3단계 — 내레이션 스크립트 작성
step-4-storyboard.md4단계 — 비트별 창의적 방향 설정
step-5-vo.md5단계 — TTS, 텍스트 변환, 타이밍
step-6-build.md6단계 — 자체 검토와 함께 컴포지션 빌드
step-7-validate.md7단계 — 린트, 검증, 미리보기, 핸드오프
techniques.md4단계 및 6단계 — SVG 드로잉, Canvas 2D, 3D, 타이포그래피, Lottie, 비디오, 타이핑, 가변 폰트, MotionPath, 전환 등 10가지 시각적 기법과 코드 패턴

관련 스킬