Communitygithub.com

HyperFrames 핵심 — 합성 계약

HyperFrames 합성 계약서 — HTML 구조, data-* 속성, 클립, 트랙. 유효한 HyperFrames HTML을 작성하기 위한 공식 참조 문서입니다.

HyperFrames 핵심 — 합성 계약란 무엇인가요?

이 스킬은 HyperFrames 합성 계약(HyperFrames Composition Contract)의 공식 참조 역할을 하며, AI 에이전트가 표준에 부합하는 HyperFrames HTML 문서를 작성할 수 있도록 안내합니다. 기본 HTML 골격, 캔버스 메타 태그, 그리고 씬(scene), 트랙(track), 클립(clip) 각 레벨의 data-* 속성 정의를 제공합니다. 세부적으로는 애니메이션, 트랜지션, 미디어 파일(비디오, 이미지, 오디오, TTS) 배치, 시간 포맷 등이 정의되어 있어 정확하고 예측 가능한 합성 출력을 보장합니다. AI 에이전트는 이 문서를 지침으로 삼아 유효한 HyperFrames 마크업을 생성할 수 있으며, 제공된 lint 명령어를 통해 문법 검증도 수행할 수 있습니다. 이는 Cursor, Claude Code, Codex 등 data-* 속성을 기반으로 하는 AI 코딩 어시스턴트 환경에서 특히 유용합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-core

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

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

미리보기

스킬 README에서

HyperFrames 핵심 — 합성 계약 preview

문서

HyperFrames 핵심 — 합성 계약은(는) 무엇을 하나요?

HTML 골격

<!DOCTYPE html>
<html data-hf-version="1">
<head>
  <meta charset="UTF-8" />
  <meta name="hf:canvas-width" content="1920" />
  <meta name="hf:canvas-height" content="1080" />
  <meta name="hf:fps" content="30" />
  <meta name="hf:duration" content="auto" />
</head>
<body>
  <div data-hf-scene="intro" data-hf-duration="5s">
    <div data-hf-track="background">
      <div data-hf-clip data-hf-start="0s" data-hf-duration="5s"
           style="background:#111;width:100%;height:100%;position:absolute;"></div>
    </div>
    <div data-hf-track="title">
      <div data-hf-clip data-hf-start="0.5s" data-hf-duration="4s"
           data-hf-animate="fade-in">
        <h1>Hello World</h1>
      </div>
    </div>
  </div>
</body>
</html>

캔버스 메타 태그

태그기본값참고
hf:canvas-width1920픽셀
hf:canvas-height1080픽셀
hf:fps30초당 프레임
hf:durationauto전체 재생 시간; 명시적 지정 가능 (예: 60s)
hf:bg-color#000기본 씬 배경

씬 속성 (data-hf-scene)

속성타입설명
data-hf-scene문자열씬 이름/ID
data-hf-duration시간5s, 10s, auto
data-hf-transition문자열cut, fade, slide-left, slide-right, zoom
data-hf-transition-duration시간기본값 0.5s
data-hf-bgURL 또는 색상씬 배경

트랙 속성 (data-hf-track)

속성타입설명
data-hf-track문자열트랙 이름
data-hf-z숫자z-index 쌓임 순서
data-hf-mute불리언이 트랙 오디오 음소거

클립 속성 (data-hf-clip)

속성타입설명
data-hf-clip—요소를 클립으로 표시
data-hf-start시간씬 내 시작 오프셋
data-hf-duration시간클립 재생 시간; auto = 콘텐츠 재생 시간
data-hf-end시간duration 대신 사용 가능
data-hf-animate문자열단축 애니메이션 프리셋
data-hf-in문자열진입 애니메이션
data-hf-out문자열퇴장 애니메이션
data-hf-volume0–1오디오 볼륨
data-hf-speed숫자재생 속도 배수
data-hf-loop불리언미디어 반복 재생
data-hf-trim-start시간미디어 시작 부분 자르기
data-hf-trim-end시간미디어 끝 부분 자르기

미디어 클립

<!-- 비디오 -->
<video data-hf-clip data-hf-start="0s" src="assets/hero.mp4" />

<!-- 이미지 (정적, 지정된 시간 동안 유지) -->
<img data-hf-clip data-hf-start="0s" data-hf-duration="3s" src="assets/logo.png" />

<!-- 오디오 -->
<audio data-hf-clip data-hf-start="0s" src="assets/music.mp3" data-hf-volume="0.4" />

<!-- TTS 내레이션 -->
<div data-hf-clip data-hf-tts="Hello, welcome to the demo." data-hf-start="1s" />

시간 형식

모든 시간 값은 CSS 스타일 표기법(0s, 1.5s, 2000ms)을 사용합니다. 소수 초도 허용됩니다.

유효성 검사

npx hyperframes lint index.html

Individual skills in this repo

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

관련 스킬