Communitygithub.com

bobzhou-source/Parsifal-Demo

HyperFrames를 사용하여 HTML, CSS, JavaScript 구성으로 AI 비디오를 만들고, 검증한 후 MP4로 렌더링합니다. 짧은 인트로, 시네마틱 트레일러, 제품 프로모션, 자막 애니메이션, HUD/기술 비주얼, 웹-비디오 변환 및 모션 그래픽에 사용하세요.

Parsifal-Demo란 무엇인가요?

이 스킬은 Parsifal 환경에서 HyperFrames를 활용하여 비디오를 제작하는 방법을 제공합니다. 사용자가 30초 세로 비디오, 짧은 인트로, 시네마틱 마이크로 트레일러, 제품 프로모션, 애니메이션 캡션, HUD 스타일 기술 비주얼, 웹-비디오 변환 또는 HTML/CSS/JS 모션 그래픽 렌더링을 요청할 때 활성화됩니다. HyperFrames는 HTML을 비디오 소스 진리(truth)로 취급하며, 장면을 HTML 구성과 CSS 레이아웃, JavaScript 애니메이션으로 구축하고 검증한 후 MP4로 렌더링합니다. 이 스킬은 Node.js와 FFmpeg가 필요하며, `npx hyperframes` 명령어를 통해 프로젝트 초기화, 린트 검사, 인스펙션, 미리보기, 최종 렌더링까지의 전체 워크플로우를 지원합니다. 완료 시 반드시 `lint`와 `inspect`로 검증하고 MP4로 렌더링해야 작업이 완료된 것으로 간주합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bobzhou-source/Parsifal-Demo/tree/HEAD/packages/skills/hyperframes

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

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

문서

HyperFrames

사용자가 Parsifal에게 HyperFrames로 비디오를 만들도록 요청할 때 이 스킬을 사용하세요. 예를 들어 30초 세로 비디오, 짧은 인트로, 시네마틱 마이크로 트레일러, 제품 프로모션, 애니메이션 캡션, HUD 스타일 기술 비주얼, 웹-비디오 변환 또는 HTML/CSS/JS 모션 그래픽 렌더링 등이 있습니다.

HyperFrames는 HTML을 비디오 소스 진리(truth)로 취급합니다. 비디오 장면을 CSS 레이아웃과 JavaScript 애니메이션이 포함된 HTML 구성으로 빌드하고, 레이아웃을 검증한 후 결과를 MP4로 렌더링합니다.

설정

HyperFrames가 설치되지 않았거나 공식 스킬이 없으면 먼저 설치하세요:

parsifal skills install official/creative/hyperframes

프로젝트 작업에는 npx hyperframes를 사용하세요. HyperFrames는 Node.js와 FFmpeg가 필요합니다. 렌더링 또는 미리보기가 실패하면 다음을 실행하세요:

npx hyperframes doctor

워크플로우

  1. 사용자의 요청을 짧은 제작 브리프로 변환하세요: 지속 시간, 화면 비율, 대상 플랫폼, 언어, 스타일, 음악 또는 내레이션 필요 여부, 최종 출력 경로.
  2. 불완전한 브리프는 합리적인 기본값을 사용하세요. 세로 짧은 비디오는 1080x1920, 가로 비디오는 1920x1080, 30fps, MP4 출력을 사용하세요.
  3. HyperFrames 프로젝트를 생성하거나 재사용하세요:
npx hyperframes init my-video --non-interactive
  1. HTML/CSS/JS로 구성을 작성하세요. 애니메이션을 추가하기 전에 정적 히어로 프레임 레이아웃이 올바른지 확인하세요.
  2. 렌더링 전에 검증하세요:
npx hyperframes lint
npx hyperframes inspect --samples 15
  1. 필요할 때 미리보기:
npx hyperframes preview
  1. 최종 비디오를 렌더링하세요:
npx hyperframes render --output final.mp4 --quality standard

빠른 반복 작업에는 --quality draft를 사용하고, 사용자가 정교한 내보내기를 요청할 때 최종 제공용으로 --quality high를 사용하세요.

구성 규칙

  • data-composition-id, data-width, data-height 속성이 있는 루트 요소를 사용하세요.
  • 시간 제한 클립에는 data-start, data-duration, data-track-index를 사용하세요.
  • GSAP 타임라인을 window.__timelines에 동기식으로 등록하세요.
  • CSS를 최종 레이아웃 상태로 사용한 다음, 그 상태에서 애니메이션을 적용하거나 그 상태로 애니메이션을 적용하세요.
  • 미디어 재생은 HyperFrames 런타임 아래에서 유지하세요. play(), pause()를 수동으로 호출하거나 미디어를 탐색하지 마세요.
  • 시드 생성기를 사용하지 않는 한 Math.random() 또는 Date.now()와 같은 비결정적 애니메이션 로직을 피하세요.
  • 무한 반복을 사용하지 마세요. 구성 지속 시간에서 유한 반복 횟수를 계산하세요.
  • 텍스트, 캡션, UI 패널 및 HUD 요소가 검사된 모든 타임스탬프에서 프레임 내에 유지되는지 확인하세요.

전달

완료되면 사용자에게 다음을 알리세요:

  • 렌더링된 MP4 경로;
  • 미리보기 서버가 실행 중인 경우 미리보기 URL;
  • 지속 시간, 화면 비율, 스타일, 내레이션 또는 음악에 대해 가정한 사항;
  • 해결되지 않은 검증 문제.

HTML을 작성한 후에 멈추지 마세요. HyperFrames 작업은 lint와 inspect로 구성을 확인하고 MP4로 렌더링한 후에만 완료됩니다. 단, 사용자가 명시적으로 소스 파일만 요청한 경우는 예외입니다.

관련 스킬