Communitygithub.com

govindgoel2001/비디오-편집-툴킷

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

비디오-편집-툴킷란 무엇인가요?

이 스킬은 HyperFrames 컴포지션 내에서 GSAP 애니메이션을 작성하기 위한 완전한 레퍼런스 가이드를 제공합니다. `gsap.to()`, `from()`, `fromTo()`와 같은 핵심 트윈 메서드와 `set()`을 포함하며, `duration`, `delay`, `ease`, `stagger`, `repeat`, `callbacks` 및 `immediateRender`와 같은 공통 속성을 설명합니다. 또한 CSS 변환을 위한 GSAP 별칭(예: `x`, `y`, `scale`, `rotation`)과 `autoAlpha`, CSS 변수, 방향 회전, 상대값, 함수 기반 값 등 고급 주제를 다룹니다. 타임라인 섹션에서는 생성, position 파라미터(절대, 상대, 정렬), 레이블, 옵션, 중첩, 재생 제어 방법을 자세히 설명합니다. 성능 모범 사례는 `transform` 및 `opacity` 사용, `will-change`, 고빈도 업데이트를 위한 `gsap.quickTo()`, `stagger` 사용, 오프스크린 애니메이션 정리 등을 강조합니다. 이 스킬은 GSAP 애니메이션이 포함된 HyperFrames 프로젝트에서 작업하는 모든 개발자에게 필수적이며, `references/effects.md` 파일도 참조할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/gsap

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

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

문서

GSAP

핵심 트윈 메서드

  • gsap.to(targets, vars) — 현재 상태에서 vars 까지 애니메이션. 가장 일반적임.
  • gsap.from(targets, vars) — vars 에서 현재 상태로 애니메이션 (등장).
  • gsap.fromTo(targets, fromVars, toVars) — 명시적 시작 및 종료.
  • gsap.set(targets, vars) — 즉시 적용 (지속 시간 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로 설정.

변환 및 CSS

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

GSAP 속성동등 속성
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().


성능

변환 및 불투명도 선호

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를 사용하세요.

정리

화면 밖 애니메이션은 일시 중지하거나 제거(kill)하세요.


참조 (요청 시 로드)

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

모범 사례

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

금지 사항

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

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

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

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

관련 스킬