Communitygithub.com

dbillion/hermes-skills-public

HyperFrames 컴포지션 계약 — 하나의 렌더링 가능한 프로젝트를 구축합니다. 컴포지션 구조, `data-*` 타이밍 속성, `class="clip"`, 트랙, 하위 컴포지션, 변수, 프레임워크 소유 미디어 재생, 결정적 렌더링 규칙 및 유효성 검사를 다룹니다. Tailwind 프로젝트와 STORYBOARD.md / SCRIPT.md 계획 형식도 포함합니다. 컴포지션 HTML을 작성하기 전에 읽어야 합니다.

hermes-skills-public란 무엇인가요?

이 스킬은 HyperFrames 프레임워크의 핵심 컴포지션 계약을 정의합니다. HyperFrames는 HTML로 비디오를 렌더링하며, DOM이 `data-*` 속성으로 타이밍을 선언하고, 애니메이션 런타임이 탐색 가능하며, 미디어 재생이 프레임워크에 의해 제어됩니다. 이 문서는 독립형 `index.html`에서 하위 컴포지션 및 Tailwind 프로젝트에 이르기까지 하나의 전체 렌더링 가능한 HyperFrames 프로젝트를 구축하는 방법에 대한 기술적 청사진 역할을 합니다. `references/` 디렉토리 내의 다양한 참조 파일로 연결되어 최소 컴포지션, 데이터 속성, 트랙 및 클립, 하위 컴포지션, 변수 및 미디어, 결정론 규칙, 스토리보드 형식 등과 같은 주제를 다룹니다. 주요 규칙에는 결정적 타임라인 시행, 고유 ID 요구 사항, 비디오/오디오 요소를 루트의 직접 하위 요소로 배치하는 것, 하위 컴포지션을 위한 `<template>` 사용 등이 포함됩니다. 이 스킬은 Claude Code와 같은 AI 에이전트가 플랫폼(Studio, CLI 등)에서 HyperFrames 프로젝트를 생성, 편집 또는 유효성 검사할 때 필수적이며, 안정적이고 일관된 렌더링을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-core

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

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

문서

HyperFrames 핵심

HyperFrames는 HTML에서 비디오를 렌더링합니다. 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임이 탐색 가능하며, 미디어 재생이 프레임워크에 의해 소유되는 HTML 파일입니다.

이 스킬은 기술 계약입니다 — 하나의 hyperframes 프로젝트를 구축하는 방법입니다. 본문은 빌드 가이드입니다. 주제별 세부 사항은 references/ (다음에 인덱스)에 있으며, 필요할 때 읽으십시오. 다른 문제는 형제 도메인 스킬인 hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry에 있습니다. /hyperframes의 기능 맵은 각각이 무엇을 포함하는지 설명합니다.

참조

파일읽을 목적
references/minimal-composition.md가장 작은 렌더링 가능한 컴포지션 스켈레톤에서 시작하기
references/composition-patterns.md모놀리식 vs 모듈식 선택; 모듈식 index.html 구조화; 하위 컴포지션 아키타입 선택
references/data-attributes.md모든 data-* (루트 / 클립 / 하위 컴포지션 호스트 / 레거시 별칭) 조회; class="clip" 사용
references/tracks-and-clips.mddata-track-index 선택, 동일 트랙 중복 / z-index 처리, 다른 클립에 상대적인 클립 타이밍 설정
references/sub-compositions.md하위 컴포지션 연결 (호스트 속성, <template>, 인스턴스별 변수) 및 내부 애니메이션
references/variables-and-media.md변수 선언; <video>/<audio> 배치, 볼륨 설정, 트리밍
references/determinism-rules.md탐색 가능한 타임라인 구축; 결정론 금지 사항; 애니메이션 가능 속성 허용 목록; 레이아웃 / 텍스트 맞춤
references/full-screen-motion.md공유 배경으로 전체 프레임 모션 제작
references/storyboard-format.mdSTORYBOARD.md 계획 (+ 파싱된 매니페스트) 제작
references/review-loop.md라이브 보드에서 계획 → 스케치 → 빌드 검토 패스 실행 — 모든 스토리보드 계획 워크플로에서 공유
references/production-loop.md승인된 계획을 최종 비디오로 전환 — 스테이지 종속성 (오디오, 프레임, 조립, 전환, 자막, 검증, 전달) 자유 형식 빌드가 직접 따름
references/brief-contract.md브리프의 기본 규칙 — 모드 도출 (협력 / 자율), 공유 필드 레지스트리, 질문 불변 사항 (질문 자체는 /hyperframes → 의도 계층에 있음)
references/brief-format.mdBRIEF.md 작성 — 워크플로의 설정이 작성하고 이후 모든 단계에서 읽는 확인된 의도 문서
references/script-format.md선택적 SCRIPT.md 고정 내레이션 작성
references/subagent-dispatch.md하위 에이전트 디스패치 동사 (병렬 팬아웃 / 백그라운드 / 대기)를 사용자 하니스에 매핑
references/tailwind.mdTailwind v4 프로젝트에서 작업 (init --tailwind; 런타임 계약은 Studio의 v3와 다름)

애니메이션 런타임 세부 사항 (GSAP API, Lottie, Three.js 등)은 hyperframes-animation → adapters/<runtime>.md로 이동하십시오.

컴포지션 구축

두 가지 루트 형식 (상호 교환 불가)

  • 독립형 (최상위 index.html) — 루트 <div data-composition-id="…">가 <body>에 직접 위치, <template> 래퍼 없음 (래핑하면 모든 콘텐츠가 숨겨지고 렌더링이 중단됨).
  • 하위 컴포지션 (data-composition-src를 통해 로드) — 루트는 반드시 <template>으로 래핑되어야 합니다.

⚠ 전송 규칙: 런타임은 <template> 콘텐츠만 복제합니다. 외부의 모든 것 (<head> 스타일/스크립트 포함)은 폐기됩니다 — <style>/<script>를 템플릿 내부에 배치하십시오. ⚠ 호스트 ID 규칙: 호스트 슬롯의 data-composition-id는 내부 템플릿의 data-composition-id 및 window.__timelines["<id>"] 키와 정확히 일치해야 합니다 — -mount/-slot/-host 접미사 없음.

파일 형태, 호스트 배선, 및 사전 렌더링 체크리스트 → references/sub-compositions.md.

루트는 크기가 지정되어야 함 (무음 레이아웃 버그)

독립형 루트에는 명시적인 크기 상자(px 단위의 width/height)가 필요하며, height:100% 요소까지의 모든 상위 요소는 확인된 높이가 있어야 합니다. 그렇지 않으면 flex/100% 자식이 ~0으로 축소되어 콘텐츠가 왼쪽 상단 모서리에 쌓입니다. 자동 게이트만으로 이를 잡는 데 의존하지 마십시오. 스냅샷을 검사하십시오. 스켈레톤 → references/minimal-composition.md.

하나의 일시 중지된 타임라인

각 컴포지션은 페이지 로드 시 동기적으로 빌드된 window.__timelines["<id>"] (키 = 루트 data-composition-id)에서 정확히 하나의 gsap.timeline({ paused: true })를 등록합니다. 렌더링 지속 시간 = 루트 data-duration이며, 타임라인 길이가 아닙니다. 하위 타임라인을 호스트에 수동으로 중첩하지 마십시오. 전체 계약 (GSAP 이외의 런타임 포함) → references/determinism-rules.md + hyperframes-animation/adapters/.

양보할 수 없는 규칙 (자동 게이트가 놓칠 수 있는 무음 버그)

여기에 표시됨; 전체 근거는 연결된 참조에서 확인하십시오. 위반하지 마십시오:

  • 렌더링 시간 시계 / 시드되지 않은 Math.random / 네트워크 / 입력 상태 없음; repeat: -1 없음 (유한 횟수 사용). → determinism-rules.md
  • 시각적 속성 허용 목록만 애니메이션; display 또는 원시 visibility를 트윈하지 마십시오. GSAP autoAlpha 및 지속 시간이 0인 타임라인 경계 설정만 유일한 가시성 예외이며, 클립이 아닌 요소 또는 클립 내부의 래퍼에만 해당됩니다. 프레임워크만 .clip 가시성을 제어합니다. 페이지 로드 시 이후 장면의 클립에 gsap.set하지 마십시오. → determinism-rules.md
  • 본문 텍스트에 <br> 없음; 변환된 요소는 블록 수준 + 크기가 지정되어야 함; 펄싱 절대 장식 요소는 피크 여유 공간이 필요함. → determinism-rules.md
  • <video>/<audio>는 호스트 루트의 직접 자식이어야 함 (하위 컴포지션 <template>/래퍼 내부에 절대 배치하지 마십시오); 프레임워크가 재생을 소유합니다. → variables-and-media.md
  • 모든 id는 조립된 페이지 전체에서 고유해야 함; 하위 컴포지션 내부에서는 id 앞에 컴포지션 id를 접두사로 붙입니다 (#<id>-hero). 중복된 <video>/<img> id는 빈 화면을 렌더링합니다 — 프로듀서는 getElementById로 프레임을 주입하며, 파일 간 중복은 lint를 빠져나갑니다. → composition-patterns.md
  • 전체 화면 장면 채우기는 전체 블리드 자식(position:absolute; inset:0)에 적용되며, 컴포지션 루트 자체에는 절대 적용하지 마십시오 — 프로듀서의 프레임 합성은 루트 요소 자체의 background를 드롭할 수 있지만(프레임이 검은색으로 렌더링됨), 미리보기/snapshot에서는 올바르게 표시됩니다. → composition-patterns.md

기존 컴포지션 편집

  • 먼저 파일을 읽으십시오. 관련 없는 타이밍, 트랙, ID, 변수, 미디어 경로를 유지하십시오.
  • 기존 컴포지션 ID 및 타임라인 키와 일치시키십시오.
  • 클립 추가: 겹치지 않는 data-track-index를 선택하거나 의도적으로 주변 타이밍을 조정하십시오.
  • 컴포지션 요소의 data-hidden은 미리보기와 렌더링 모두에서 요소를 숨기고 시간 창을 재정의합니다. 비파괴적/가역적이며 Studio의 타임라인 눈 아이콘으로 전환됩니다.
  • 하위 컴포지션 추가: 호스트를 배선하기 전에 내부 data-composition-id를 확인하십시오.

유효성 검사

명령 세부 사항은 hyperframes-cli 사용

  • npx hyperframes check 통과 (lint, 런타임, 레이아웃, 모션 및 대비에서 0개의 결과)
  • 하위 컴포지션이 있는 프로젝트: npx hyperframes snapshot --at <midpoints> 및 각 프레임을 육안으로 확인
  • 검토용 npx hyperframes preview (사용자는 Studio의 타임라인에서 무엇이든 편집 가능)
  • 사용자가 승인한 후에만 npx hyperframes render

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

dbillion/hermes-skills-public

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

dbillion/hermes-skills-public

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

관련 스킬