Communitygithub.com

rbrown101010/codex-marketing-skills

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

codex-marketing-skills란 무엇인가요?

이 스킬은 HyperFrames 환경에서 GSAP(GreenSock Animation Platform) 애니메이션을 작성하기 위한 포괄적인 레퍼런스입니다. 개발자는 이 스킬을 통해 GSAP의 핵심 트윈 메서드(gsap.to(), from(), fromTo(), set()), 공통 속성(duration, ease, stagger, repeat 등), CSS transform 별칭(x, y, scale, rotation 등), 타임라인 생성 및 제어, 성능 최적화 기법을 쉽게 참조할 수 있습니다. 특히 타임라인의 position 파라미터, 레이블, 중첩, matchMedia()를 활용한 반응형 및 접근성(모션 감소) 대응 방법을 상세히 설명합니다. 또한 gsap.quickTo()와 같은 성능 최적화 도구와 스테거(stagger) 사용법을 제공하여 복잡한 애니메이션을 효율적으로 구현할 수 있도록 돕습니다. 이 스킬은 Claude Code와 같은 AI 코딩 어시스턴트와 함께 사용되어 HyperFrames 기반 프로젝트에서 GSAP 애니메이션 코드를 생성하거나 리팩토링할 때 유용합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/hyperframes-gsap

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

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

문서

GSAP

핵심 트윈 메서드

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

항상 camelCase 속성 이름을 사용하세요(예: 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로 설정합니다.

Transform 및 CSS

원시 transform 문자열보다 GSAP의 transform 별칭을 선호하세요:

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,
});

이징

내장 이즈: 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 — 모든 하위 트윈에 병합되는 변수입니다.

타임라인 중첩

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


성능

Transform 및 Opacity 선호

x, y, scale, rotation, opacity 애니메이션은 컴포지터에서 유지됩니다. transform으로 동일한 효과를 얻을 수 있다면 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용 기성 효과 패턴이 필요할 때 읽어보세요.

모범 사례

  • camelCase 속성 이름을 사용하고 transform 별칭과 autoAlpha를 선호하세요.
  • delay로 체이닝하는 것보다 타임라인을 선호하고 position 파라미터를 사용하세요.
  • addLabel()로 레이블을 추가하여 가독성 있는 시퀀싱을 만드세요.
  • 타임라인 생성자에 defaults를 전달하세요.
  • 재생 제어가 필요할 때 트윈/타임라인의 반환 값을 저장하세요.

하지 말 것

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

Individual skills in this repo

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

관련 스킬