Communitygithub.com

DigitalRavagers/Experiment

HyperFrames 애니메이션에 대한 모든 지식 — 원자적 모션 규칙, 다단계 씬 청사진, 씬 전환, 광범위한 모션 디자인 기법 및 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU). 모션 또는 애니메이션 작업에 사용: 2~4개의 규칙을 선택하여 구성하거나, 청사진을 로드하거나, 런타임별 API(GSAP 이징, Lottie 플레이어, Three.js 믹서 등)를 조회하세요. HyperFrames 네이티브: 단일 일시 중지 타임라인, 탐색 가능, 결정론적.

Experiment란 무엇인가요?

이 스킬은 HyperFrames 에코시스템 내에서 모션 및 애니메이션 작업을 위한 포괄적인 지식 기반을 제공합니다. 원자적 모션 규칙(rules-index.md), 다단계 씬 청사진(blueprints-index.md), 씬 전환(transitions/overview.md 및 catalog.md), 광범위한 모션 디자인 기법(techniques.md), 그리고 GSAP(기본), Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU를 포함한 7가지 런타임 어댑터로 구성됩니다. GSAP 기반 원자적 규칙을 빠르게 2~4개 조합하여 사용하거나, 복잡한 다단계 씬을 위해 미리 설계된 청사진을 로드할 수 있습니다. 주요 제약 조건으로는 단일 일시 중지 타임라인 사용, data-duration으로 길이 제어, Math.random/Date.now/performance.now 사용 금지, 레이아웃 변경에 width/height/top/left 대신 GSAP 변환 별칭(x, y, scale, rotation)만 사용 등이 있습니다. 이 스킬은 Claude Code, Cursor, Codex 등 HyperFrames와 통합된 AI 코딩 에이전트에서 사용하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/hyperframes-animation

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

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

문서

HyperFrames 애니메이션

모든 모션 지식이 하나의 스킬에 담겨 있습니다:규칙(원자적 레시피), 청사진(다단계 씬 템플릿), 전환(씬 간), 기법(광범위한 모션 디자인 패턴), 그리고 어댑터(런타임별 API).

구성 계약(데이터 속성, 하위 구성, 결정론)은 hyperframes-core를 참조하세요.

기본값: 원자적 규칙 구성

rules-index.md에서 2~4개의 규칙을 선택하고, 단일 일시 중지 GSAP 타임라인으로 함께 연결하면 됩니다. 이 방법이 청사진부터 시작하는 것보다 빠르고 코드도 적게 생성됩니다.

청사진 로드 시점

  • 씬이 기존에 미리 설계된 다단계 템플릿(브랜드 공개, 사회적 증명, 데모 페이지 스크롤 스포트라이트 등)과 일치하고 해당 단계 파이프라인을 재사용하면 실제 제작 시간을 절약할 수 있는 경우
  • 복잡한 4~5단계 안무에 대한 실행 가능한 확정 코드가 필요한 경우

청사진은 blueprints-index.md에 있습니다. 각 항목은 blueprints/<id>.md(레시피)와 examples/<id>.html(실행 가능 샘플)을 가리킵니다. 추측으로 읽지 말고, 씬 수준 오케스트레이션이 필요하다고 결정한 후에 로드하세요.

라우팅

원하는 작업…읽을 파일
트리거/태그별 원자적 모션 패턴 선택rules-index.md
하나의 규칙에 대한 전체 HTML / CSS / GSAP 레시피 읽기rules/<name>.md
다단계 씬 템플릿 선택blueprints-index.md
하나의 청사진에 대한 전체 레시피 읽기blueprints/<id>.md + examples/<id>.html
씬 전환 제작 (CSS 기반, 두 클립 간)transitions/overview.md, transitions/catalog.md
광범위한 모션 디자인 기법 조회techniques.md
기존 구성의 애니메이션 맵 분석scripts/animation-map.mjs
GSAP API — 타임라인 / 트윈 / 위치 매개변수adapters/gsap.md
GSAP — 드롭인 효과 레시피rules/gsap-effects.md
GSAP — 변환 / 성능adapters/gsap-transforms-and-perf.md
GSAP — 이징 / 스태거adapters/gsap-easing-and-stagger.md
GSAP — 타임라인 / 레이블adapters/gsap-timeline-and-labels.md
Lottie / dotLottie (After Effects 내보내기, window.__hfLottie)adapters/lottie.md
Three.js / WebGL (3D 씬, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
CSS 키프레임 (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), currentTime 탐색)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, 컴퓨트 파이프라인)adapters/typegpu.md
HTML-as-texture + WebGL/GLSL 포스트 FX (drawElementImage로 라이브 DOM 캡처)adapters/html-in-canvas-patterns.md
명명된 텍스트 애니메이션 효과 (외부 animate-text 스킬을 통한 24개 ID)adapters/animate-text.md

런타임 선택

  • GSAP는 95%의 모션 작업에 기본값입니다 — 타임라인 오케스트레이션, 변환, 이징, 스태거를 다룹니다. 이 스킬의 모든 원자적 규칙은 GSAP 기반입니다.
  • Lottie는 자산에 자체 사전 제작 타임라인이 있는 경우(일반적으로 After Effects 내보내기) 사용합니다.
  • Three.js는 3D 씬, 카메라 모션, 셰이더 기반 비주얼에 사용합니다.
  • Anime.js는 GSAP이 과할 때 경량 트위닝에 사용합니다.
  • CSS는 단순 반복 모티프, 장식, 반짝임 효과 — JavaScript 애니메이션 비용 없음.
  • WAAPI는 GSAP 종속성 없이 네이티브 브라우저 키프레임에 사용합니다.
  • TypeGPU / WebGPU는 GPU 렌더링 캔버스(파티클, 액체 유리, 커스텀 셰이더)에 사용합니다.

여러 런타임이 하나의 구성 내에서 공존할 수 있습니다. 각 런타임은 런타임별 전역에 자체 인스턴스를 등록하여 HyperFrames가 한 번에 모두 탐색할 수 있도록 합니다.

중요 제약 조건

전제 조건: hyperframes-core → 필수 규칙(단일 일시 중지 타임라인, data-duration이 길이를 결정, Math.random / Date.now / performance.now 사용 금지, repeat: -1 금지, 이후 씬 클립에 gsap.set 사용 금지, display / visibility 애니메이션 금지, async / setTimeout / Promise 내부에서 타임라인 구축 금지). 여기서는 다시 설명하지 않습니다.

코어 계약 위에 추가된 애니메이션 제작 사항:

  • 사전 계산된 레이아웃 상수 — 트윈 시간에 getBoundingClientRect()에서 위치를 절대 파생하지 마십시오. 트윈 시간 DOM 측정은 렌더러가 병렬로 샘플링하기 때문에 동기화가 깨집니다. 구성 설정 시 한 번 좌표를 계산하고 재사용하십시오.
  • 공간 모션은 GSAP 변환 별칭만 사용합니다(x, y, scale, rotation). 코어의 허용 목록은 비공간 속성 트윈을 위해 opacity / color / backgroundColor / borderRadius도 허용하지만, 레이아웃 변경을 위해 width / height / top / left는 절대 사용하지 마십시오.

스크립트

node skills/hyperframes-animation/scripts/animation-map.mjs <composition-dir> \
  --out <composition-dir>/.hyperframes/anim-map

window.__timelines에 등록된 모든 GSAP 타임라인을 읽고, 트윈을 열거하고, 경계 상자를 샘플링하고, 플래그를 계산하여 animation-map.json을 출력합니다. 제작 후 안무(데드 존, 스태거 일관성, 수명 주기 경고)를 감사하는 데 사용하십시오.

참조

  • hyperframes-core — 구성 구조, 데이터 속성, 하위 구성, 결정론적 렌더링 계약
  • hyperframes-creative — 팔레트, 타이포그래피, 내레이션, 비트 계획(비애니메이션 크리에이티브 방향)
  • hyperframes-cli — npx hyperframes lint / validate / inspect / preview / render

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

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

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

관련 스킬