Communitygithub.com

HyperFrames 비디오 (AIgent 디자인 시스템)

웹사이트, 제품 인터페이스, 디자인 시스템 결과물을 HyperFrames, 공식 스킬, AIgent 프로덕션 계약을 통해 결정론적 HTML 기반 비디오로 변환합니다.

HyperFrames 비디오 (AIgent 디자인 시스템)란 무엇인가요?

이 스킬은 HyperFrames를 사용하여 웹사이트, UI, 디자인 시스템을 HTML 기반 비디오(제품 투어, 런칭 필름, README 워크스루, 소셜 광고 등)로 변환하는 AIgent 프로덕션 워크플로우를 정의합니다. AIgent는 제품, 디자인, 자산, 권리 및 전달 계약을 총괄하고, 상위 HyperFrames 스킬은 컴포지션 구문, 미디어 준비, 린팅, 검사, 미리보기, 렌더링을 담당합니다. 이 스킬은 Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용할 수 있으며, HTML, CSS, GSAP, Three.js, Lottie, 캡션, 오디오, 데이터를 하나의 결정론적 타임라인으로 통합해야 할 때 유용합니다. 기존 웹사이트나 Studio 프로젝트를 비디오로 전환하거나, 동일한 구성을 다양한 화면 비율(랜드스케이프, 포트레이트, 스퀘어 등)로 변환해야 할 때 사용합니다. 워크플로우는 캡처 → 디자인 → 스크립트 → 스토리보드 → 시간 → 빌드 → 검사 → 렌더링 → 전달 순서로 진행됩니다. 각 단계에서 공식 HyperFrames 계약(`data-composition-id`, 트랙, 미디어, 등록된 타임라인 등)을 따르며, 최종 출력물로 랜드스케이프 마스터, 포트레이트/스퀘어 변형, 포스터/썸네일, 전사/캡션, 자산 매니페스트를 생성합니다. 중요한 제약사항으로는 가짜 제품 주장 금지, 승인되지 않은 사이트 캡처 금지, 결정론적 탐색을 깨는 랜덤 애니메이션 금지, 브라우저 런타임 의존성 금지, 권리·포스터·모바일·실패 상태 결정 없는 공개 전달 금지 등이 있습니다. 렌더링된 출력물이나 명시적 플레이스홀더 계약 없이 프롬프트나 스토리보드만으로 완료를 선언할 수 없습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wrg32786/aigent-design-system/tree/HEAD/skills/hyperframes-video

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

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

문서

HyperFrames 비디오

HyperFrames는 웹사이트, 인터페이스, 데이터 스토리, 또는 디자인 시스템 표면이 제품 투어, 런칭 필름, README 워크스루, 소셜 광고, 또는 재사용 가능한 모션 그래픽 패키지가 되어야 할 때 선호되는 오픈소스 경로입니다.

AIgent는 제품, 디자인, 자산, 권리, 전달 계약을 소유합니다. 상위 HyperFrames 스킬은 프레임워크별 컴포지션 구문, 미디어 준비, 린팅, 검사, 미리보기, 렌더링을 담당합니다.

먼저 읽을 문서

  1. PRODUCT.md
  2. DESIGN.md
  3. 완료된 에셋 브리프
  4. integrations/hyperframes/README.md
  5. creative-production/pipelines/hyperframes.md
  6. 설치 후 상위 HyperFrames 스킬

상위 프로덕션 스킬 설치

npx skills add heygen-com/hyperframes

프로젝트 내에 HyperFrames 프레임워크 규칙을 복사하거나 부분적으로 재구현하지 마세요. 유지 관리되는 상위 스킬과 CLI를 재사용하세요.

HyperFrames 사용 시기

  • 기존 웹사이트 또는 Studio 프로젝트를 비디오로 만들어야 할 때;
  • HTML, CSS, GSAP, Three.js, Lottie, 캡션, 오디오, 데이터가 하나의 결정론적 타임라인을 공유해야 할 때;
  • 동일한 컴포지션이 랜드스케이프, 포트레이트, 스퀘어, 포스터, 짧은 루프 변형을 생성해야 할 때;
  • 에이전트가 React 전용 비디오 프로젝트가 아닌 일반 HTML이 필요할 때;
  • 출력물이 CI 또는 자동화된 콘텐츠 파이프라인에서 재현 가능해야 할 때.

다음의 경우 Remotion을 대신 사용하세요: 프로덕션 시스템이 이미 React 우선이고, 타입이 지정된 React 컴포넌트가 내구성 있는 소스이거나, 성숙한 클라우드 렌더링 생태계가 결정적인 요구사항인 경우.

다음의 경우 직접 화면 녹화를 사용하세요: 작업이 문자 그대로의 상호작용을 문서화하는 것이 전부이고, 제작된 모션, 재사용 가능한 변형, 캡션 또는 브랜드 번역이 가치를 더하지 않는 경우.

프로덕션 루프

캡처 → 디자인 → 스크립트 → 스토리보드 → 시간 → 빌드 → 검사 → 렌더링 → 전달

캡처

기존 웹사이트의 경우, 상위 website-to-hyperframes 워크플로우를 사용하세요. 장면을 만들기 전에 실제 제품 상태, 반응형 동작, 중요한 상호작용, 승인된 자산을 기록하세요.

디자인

프로젝트 디자인 시스템을 프레임 규칙으로 변환하세요. 토큰, 타이포그래피 역할, 재료, 모션 특성, 안티패턴은 유지하되, 고정 카메라와 시간 순서에 맞게 재구성하세요. 적절한 경우 HyperFrames frame.md 지침을 사용하세요.

스크립트 및 스토리보드

애니메이션 전에 내러티브 비트를 정의하세요. 각 비트는 다음을 기록합니다:

  • 시청자 핵심 메시지;
  • 지속 시간 및 음성 대본;
  • 히어로 프레임;
  • 카메라 및 깊이;
  • 진입 및 전환;
  • 미디어 및 사운드;
  • 데스크톱, 포트레이트, 스퀘어의 영향.

빌드

정적 히어로 프레임 레이아웃으로 시작한 다음, 탐색 가능한 애니메이션을 추가하세요. 컴포지션 타이밍을 결정론적으로 유지하세요. data-composition-id, 트랙, 미디어, 등록된 타임라인, 유한 반복, 장면 전환에 대한 공식 HyperFrames 계약을 따르세요.

검사

npx hyperframes lint
npx hyperframes inspect
npx hyperframes preview

렌더링 전에 클리핑, 오버플로우, 트랙 충돌, 읽을 수 없는 캡션, 레이아웃 오류를 수정하세요.

렌더링

npx hyperframes render --quality high --output final.mp4

전달에 실제로 필요한 변형만 렌더링하세요.

필수 출력물

  • 해당하는 경우 랜드스케이프 마스터;
  • 요청 시 포트레이트 및 스퀘어 변형;
  • 포스터 또는 썸네일;
  • 웹사이트용 모션 감소 또는 정적 대체;
  • 선택적 짧은 애니메이션 README 파생물;
  • 내레이션이 있을 경우 전사 및 캡션;
  • 소스 권리 및 HyperFrames 버전이 포함된 자산 매니페스트;
  • 렌더링된 미디어가 웹사이트로 돌아갈 때의 실제 페이지 검증.

가드레일

  • 가짜 제품 주장, 지표, 추천, 또는 인터페이스 상태를 만들지 마세요.
  • 명시적 권한 없이 비공개 또는 인증된 웹사이트를 캡처하지 마세요.
  • 결정론적 탐색을 깨는 벽시계 시간 또는 랜덤 애니메이션을 사용하지 마세요.
  • HyperFrames가 자산을 생성했다는 이유만으로 브라우저 런타임 의존성을 만들지 마세요.
  • 권리, 속성, 포스터, 모바일, 실패 상태 결정 없이 공개 전달하지 마세요.
  • 프롬프트나 스토리보드로 완료를 선언하지 마세요. 렌더링된 출력물 또는 명시적 플레이스홀더 계약을 제공하세요.

관련 스킬