Communitygithub.com

MattiaIppoliti/tia-skills

HyperFrames 애니메이션에 대한 모든 지식: 원자적 모션 규칙, 다단계 씬 청사진, 씬 전환, 광범위한 모션 디자인 기술, 그리고 7가지 런타임 어댑터(GSAP 기본, Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU).

tia-skills란 무엇인가요?

이 스킬은 HyperFrames 기반 애니메이션 작업을 위한 포괄적인 레퍼런스입니다. '규칙(atomic rules)'은 위치, 크기, 회전 등 하나의 동작을 정의하는 최소 단위 레시피이며, '청사진(blueprints)'은 브랜드 리빌, 소셜 프루프 등 재사용 가능한 다단계 씬 템플릿을 제공합니다. 또한 CSS 기반 씬 전환, 모션 디자인 패턴(기법), 그리고 GSAP, Lottie, Three.js, Anime.js, CSS 애니메이션, Web Animations API, TypeGPU 등 7가지 런타임에 대한 상세 API 가이드를 포함합니다. 주요 사용 사례로는 2-4개의 원자 규칙을 조합하여 빠르게 애니메이션을 제작하거나, 복잡한 시나리오에서는 청사진을 로드하고, 기존 컴포지션의 애니메이션 맵을 감사(animation-map.mjs 스크립트)하는 기능을 지원합니다. 모든 동작은 단일 일시 정지 타임라인을 기반으로 하여 seek-safe하고 결정론적이며, 'hyperframes-core'의 규칙(예: data-duration, 랜덤 함수 금지)을 엄격히 따릅니다. 현재 코드 예제는 더 이상 사용되지 않는 HTML+GSAP 런타임을 대상으로 하지만, 모션 설계 원칙은 여전히 유효하며 Remotion 기반 HyperFrames에 적용할 때 주의사항(예: interpolate 사용, 프레임 기반 계산)을 안내합니다.

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

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

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

문서

⚠ 계약 상태: 제작(craft)은 최신, 코드는 아님

이 스택의 출력 프레임워크는 Remotion + React (/hyperframes-core)입니다. 여기의 모션 제작 지식은 여전히 유효합니다: 타이밍, 이징 선택, 움직임의 형태, 명명된 규칙과 청사진. 코드는 유효하지 않습니다: 예제와 어댑터는 더 이상 사용되지 않는 HTML + 일시 정지 GSAP 타임라인 런타임을 기준으로 작성되었습니다.

읽으면서 다음과 같이 번역하세요:

여기 (이전 방식)Remotion에서의 방식
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), 눈으로 조정
window.__timelines[id]의 일시 정지 타임라인없음; 모든 값은 useCurrentFrame()의 함수
클립의 data-start / data-duration<Sequence from> / durationInFrames (프레임 단위)
CSS keyframe 또는 transition프레임 기반 인라인 style (CSS 애니메이션은 렌더링되지 않음)

이 스킬의 예제를 수정하지 않고 Remotion 프로젝트에 붙여넣지 마십시오.

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 keyframes (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), currentTime seek)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가 한 번에 모두 seek할 수 있도록 합니다.

중요 제약 조건

전제 조건: hyperframes-core → 절대 타협할 수 없는 규칙(단일 일시 정지 타임라인, data-duration이 길이를 결정, Math.random / Date.now / performance.now 사용 금지, repeat: -1 사용 금지, 이후 씬 클립에 대한 페이지 로드 시 gsap.set 사용 금지, display 또는 원시 visibility 트윈 사용 금지, 그리고 async / setTimeout / Promise 내부의 타임라인 구성 금지). GSAP autoAlpha 및 명시적 타임라인 경계에서의 지속 시간 0 가시성 설정은 코어에서 계속 허용됩니다. 이러한 예외는 클립이 아닌 요소나 클립 내부의 래퍼에만 사용하십시오. 프레임워크가 .clip 라이프사이클을 소유합니다. 전체 계약을 여기에 다시 기술하지 마십시오.

코어의 계약에 추가되는 애니메이션 제작 규칙:

  • 사전 계산된 레이아웃 상수 — 트윈 시간에 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을 출력합니다. 제작 후 안무(데드 존, 스테거 일관성, 라이프사이클 경고)를 감사하는 데 사용하십시오.

animation-map.mjs는 먼저 현재 프로젝트에서 헬퍼 패키지를 확인한 다음, 번들된 HyperFrames 패키지 버전을 부트스트랩할 수 있습니다. 번들된 CLI/스킬 설치 외부에서 스킬을 실행 중이고 해당 부트스트랩 버전을 명시적으로 고정해야 하는 경우에만 HYPERFRAMES_SKILL_PKG_VERSION=<version>을 설정하십시오.

참조

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

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

관련 스킬