Communitygithub.com

nateherkai/hyperframes-student-kit

HyperFrames 구성을 위한 GSAP 애니메이션 레퍼런스입니다. gsap.to(), from(), fromTo(), easing, stagger, defaults, 타임라인(gsap.timeline(), position 파라미터, 레이블, 중첩, 재생 제어) 및 성능 최적화(트랜스폼, will-change, quickTo)를 다룹니다. HyperFrames 구성에서 GSAP 애니메이션을 작성할 때 사용하세요.

hyperframes-student-kit란 무엇인가요?

이 스킬은 HyperFrames 환경에서 GSAP(GreenSock Animation Platform)을 사용하여 고성능 웹 애니메이션을 작성하기 위한 포괄적인 레퍼런스 가이드입니다. 핵심 트윈 메서드(gsap.to, from, fromTo, set)부터 시작하여 duration, delay, ease, stagger, repeat 등 다양한 옵션을 상세히 설명합니다. 특히 CSS transform aliases(x, y, scale, rotation 등)와 autoAlpha를 권장하며, width/height 같은 레이아웃 속성 애니메이션을 피하도록 안내합니다. 타임라인 기능을 통해 복잡한 시퀀스를 직관적으로 구성할 수 있으며, position 파라미터와 레이블을 사용하여 정밀한 재생 제어가 가능합니다. gsap.matchMedia()를 활용한 반응형 및 접근성 대응, gsap.quickTo()를 통한 성능 최적화, stagger를 이용한 효율적인 다중 요소 애니메이션 등 실무에 필요한 모든 패턴을 다룹니다. HyperFrames 사용자를 위해 특별히 설계되었으며, references/effects.md 파일을 통해 바로 사용 가능한 효과 패턴도 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/gsap

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

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

문서

GSAP

핵심 트윈 메서드

  • gsap.to(targets, vars) — 현재 상태에서 vars로 애니메이션합니다. 가장 일반적입니다.
  • gsap.from(targets, vars) — vars에서 현재 상태로 애니메이션합니다(진입 효과).
  • gsap.fromTo(targets, fromVars, toVars) — 시작과 끝을 명시적으로 지정합니다.
  • gsap.set(targets, vars) — 즉시 적용합니다(지속 시간 0).

항상 카멜케이스 프로퍼티 이름을 사용하세요(예: backgroundColor, rotationX).

일반적인 vars

  • duration — 초(기본값 0.5).
  • delay — 시작 전 지연 시간(초).
  • ease — "power1.out"(기본값), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — 숫자 0.1 또는 객체: { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false(기본값), true, 또는 "auto".
  • repeat — 숫자 또는 무한 반복 -1. yoyo — 반복 시 방향을 번갈아 가며 전환합니다.
  • onComplete, onStart, onUpdate — 콜백 함수.
  • immediateRender — from()/fromTo()의 기본값 true. 나중에 동일한 속성+요소를 대상으로 하는 트윈에서 덮어쓰기를 방지하려면 false로 설정하세요.

트랜스폼과 CSS

원시 transform 문자열 대신 GSAP의 transform aliases를 선호하세요:

GSAP 속성동등한 CSS 속성
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y (%)
scale, scaleX, scaleYscale
rotationrotate (deg)
rotationX, rotationY3D rotate
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — opacity보다 선호합니다. 0일 경우 visibility: hidden도 설정합니다.
  • CSS 변수 — "--hue": 180.
  • svgOrigin (SVG 전용) — 전역 SVG 좌표 공간 원점입니다. transformOrigin과 함께 사용하지 마세요.
  • 방향 회전 — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" 또는 쉼표로 구분된 값; 완료 시 인라인 스타일을 제거합니다.
  • 상대 값 — "+=20", "-=10", "*=2".

함수 기반 값

gsap.to(".item", {
  x: (i, target, targets) => i * 50,
  stagger: 0.1,
});

Easing

내장 이징: power1–power4, back, bounce, circ, elastic, expo, sine. 각각 .in, .out, .inOut 접미사가 있습니다.

기본값

gsap.defaults({ duration: 0.6, ease: "power2.out" });

트윈 제어

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia() (반응형 + 접근성)

미디어 쿼리가 일치할 때만 설정을 실행하고, 일치하지 않으면 자동으로 되돌립니다.

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (context) => {
    const { isDesktop, reduceMotion } = context.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

타임라인

타임라인 생성

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

Position 파라미터

세 번째 인수로 배치를 제어합니다:

  • 절대적: 1 — 1초 지점
  • 상대적: "+=0.5" — 끝난 후; "-=0.2" — 끝나기 전
  • 레이블: "intro", "intro+=0.3"
  • 정렬: "<" — 이전 트윈과 동시 시작; ">" — 이전 트윈이 끝난 후; "<0.2" — 이전 트윈 시작 후 0.2초
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // .a와 동시 시작
tl.to(".c", { opacity: 0 }, "<0.2"); // .b 시작 후 0.2초

레이블

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

타임라인 옵션

  • paused: true — 일시 정지 상태로 생성; .play()를 호출하여 시작합니다.
  • repeat, yoyo — 전체 타임라인에 적용됩니다.
  • defaults — 모든 하위 트윈에 병합되는 vars입니다.

타임라인 중첩

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

재생 제어

tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().


성능

트랜스폼과 opacity 선호

x, y, scale, rotation, opacity 애니메이션은 컴포지터에서 처리됩니다. 트랜스폼으로 동일한 효과를 얻을 수 있다면 width, height, top, left 사용을 피하세요.

will-change

will-change: transform;

실제로 애니메이션되는 요소에만 적용하세요.

잦은 업데이트를 위한 gsap.quickTo()

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

다중 트윈보다 Stagger

수동 지연을 사용한 개별 트윈 대신 stagger를 사용하세요.

정리

화면 밖 애니메이션은 일시 중지하거나 종료하세요.


참조 (필요 시 로드)

  • references/effects.md — 바로 사용 가능한 효과: 타자기 텍스트, 오디오 시각화 도구. HyperFrames용 즉시 사용 가능한 효과 패턴이 필요할 때 읽어보세요.

모범 사례

  • 카멜케이스 프로퍼티 이름을 사용하세요; transform aliases와 autoAlpha를 선호하세요.
  • delay를 사용한 체이닝보다 타임라인을 선호하세요; position 파라미터를 사용하세요.
  • 읽기 쉬운 시퀀싱을 위해 addLabel()로 레이블을 추가하세요.
  • 타임라인 생성자에 defaults를 전달하세요.
  • 재생 제어가 필요할 때는 트윈/타임라인의 반환 값을 저장하세요.

금지 사항

  • 트랜스폼으로 충분할 때 레이아웃 속성(width/height/top/left)을 애니메이션하지 마세요.
  • 동일한 SVG 요소에 svgOrigin과 transformOrigin을 함께 사용하지 마세요.
  • 타임라인으로 시퀀싱할 수 있는 애니메이션을 delay로 체이닝하지 마세요.
  • DOM이 존재하기 전에 트윈을 생성하지 마세요.
  • 정리를 건너뛰지 마세요 — 더 이상 필요하지 않은 트윈은 항상 종료하세요.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

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, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

관련 스킬