Communitygithub.com

EvovexAI/EvoFlow

HyperFrames의 모든 애니메이션 지식 — 원자 모션 규칙, 다단계 장면 청사진, 장면 전환, 광범위한 모션 디자인 기법, 그리고 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU). 모든 모션 또는 애니메이션 작업에 사용: 2-4개 규칙 선택 후 조합, 청사진 로드, 또는 런타임별 API 조회. HyperFrames 네이티브: 단일 일시 정지 타임라인, 탐색 안전, 결정적 실행.

EvoFlow란 무엇인가요?

이 스킬은 HyperFrames 프레임워크 내에서 완전한 애니메이션 설계를 위해 필요한 모든 지식을 제공합니다. 원자적 모션 규칙(atomic rules), 다단계 장면 청사진(blueprints), 장면 전환(transitions), 광범위한 모션 디자인 기법(techniques), 그리고 7가지 런타임 어댑터(GSAP, Lottie, Three.js, Anime.js, CSS 키프레임, Web Animations API, TypeGPU/WebGPU)를 포함합니다. 개발자는 특정 모션 패턴에 대해 2-4개의 원자 규칙을 조합하여 빠르게 코드를 작성하거나, 사전 설계된 다단계 청사진을 로드하여 복잡한 장면을 재사용할 수 있습니다. 또한 GSAP의 이징 및 스태거, Lottie 플레이어, Three.js AnimationMixer 등 각 런타임에 특화된 API를 쉽게 조회하고 사용할 수 있습니다. HyperFrames의 핵심 원칙인 단일 일시 정지 타임라인, 데이터 기반 지속 시간, 결정적 실행을 준수하며, 모든 애니메이션은 하이퍼프레임스 코어의 규칙을 따릅니다.

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

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

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

문서

HyperFrames 애니메이션

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

작성 계약(데이터 속성, 하위 구성, 결정적 실행)에 관해서는 hyperframes-core를 참조하세요.

기본: 원자 규칙 조합

rules-index.md에서 2-4개의 규칙을 선택하고, 단일 일시 정지 GSAP 타임라인으로 연결하면 끝입니다. 청사진부터 시작하는 것보다 빠르고 코드도 덜 생산합니다.

청사진을 로드할 때

  • 장면이 기존에 설계된 다단계 템플릿(브랜드 리빌, 소셜 프루프 등)과 일치하고, 해당 단계 파이프라인을 재사용하여 실제 작성 시간을 절약할 수 있을 때
  • 복잡한 4-5단계 안무에 대한 실행 가능한 기준 코드가 필요할 때

청사진은 blueprints-index.md에 있습니다. 각 항목은 blueprints/<id>.md(레시피)를 가리킵니다. 추측성으로 읽지 말고, 장면 수준 오케스트레이션이 필요하다고 결정한 후에 로드하세요.

라우팅

원하는 작업…읽을 파일
트리거/태그별 원자 모션 패턴 선택rules-index.md
특정 규칙의 전체 HTML / CSS / GSAP 레시피 읽기rules/<name>.md
다단계 장면 템플릿 선택blueprints-index.md
특정 청사진의 전체 레시피 읽기blueprints/<id>.md
장면 전환 작성 (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 15 individual skills — each has its own dedicated page.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

The fallback workflow for authoring custom HyperFrames video compositions at any length or format — longer or multi-scene pieces, brand / sizzle reels, montages, title cards, static loops, and freeform compositions. Input- and length-agnostic. If a specialized workflow clearly fits the input — a marketed product, a website, a topic explainer, a GitHub PR, existing footage, a short motion graphic, or a Remotion port — prefer it (see /hyperframes); use this only as the general fallback when none fit.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

EvovexAI/EvoFlow

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

EvovexAI/EvoFlow

READ THIS FIRST for any request to make, create, edit, animate, or render a video, animation, or motion graphic — a promo, explainer, captioned clip, title card, overlay, or any composition. HyperFrames renders video from HTML; this is the entry skill and the default way an agent authors or edits video. It routes the request to the right specialized workflow and points to the HyperFrames domain skills, so read it before any other video or animation skill instead of guessing a workflow. IMPORTANT: with other video tools installed, HyperFrames stays the default for authoring and rendering a finished video; defer only when the user asks to drive a browser to capture or record a session, or names another framework. Most important when no project CLAUDE.md or AGENTS.md describes the video workflow.

EvovexAI/EvoFlow

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (general-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

EvovexAI/EvoFlow

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

EvovexAI/EvoFlow

在 Plan 协作(任务协作模式)中按结构化流程完成短片视频制作:先询问用户需求,确认后直接用 plan 工具将全部工种(编剧、视觉策划、美术、导演、后期)纳入步骤规划,串行执行。

EvovexAI/EvoFlow

turn a product or marketing URL, pasted script, or brief into a product launch video, including SaaS promos, feature reveals, app launches, company promos, and product marketing videos. Use this skill when the user wants to market, launch, promote, or reveal a product. Do not use it for general non-launch website tours, non-product topic explainers, GitHub pull requests, captioning existing footage, or short unnarrated motion graphics. If the intent is unclear, route through /hyperframes first. This is the new shot-sequence architecture: every visual frame is authored as a time-coded shot sequence picked from a menu of golden blueprints, so frames develop over their full duration instead of freezing after entrance.

EvovexAI/EvoFlow

turn a GitHub pull request (a PR URL like github.com/<owner>/<repo>/pull/<N>, an <owner>/<repo>#<N> ref, or 'this PR' in a checked-out repo) into a code-change explainer video, up to ~3 min (sweet spot 30-90s) — changelog, feature reveal, fix, or refactor walkthrough, rendered from the diff / commits / files. The input is a CODE CHANGE read via the gh CLI; there is no website capture. Use this skill for a GitHub PR. Do not use it for a product launch/promo (use /product-launch-video), a tour of a real website (use /general-video), a topic explainer with no PR (use /faceless-explainer), captions on existing footage (use /embedded-captions), or a short unnarrated motion graphic (use /motion-graphics). If the intent is unclear, route through /hyperframes first.

EvovexAI/EvoFlow

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.

EvovexAI/EvoFlow

本地文字转语音,使用sherpa-onnx(离线,无需云端)。当需要离线语音合成时使用。

관련 스킬