Communitygithub.com

assafkip/claude-video-editor

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

claude-video-editor란 무엇인가요?

이 스킬은 HyperFrames 컴포지션 내에서 GSAP 애니메이션을 작성하기 위한 포괄적인 참조 가이드 역할을 합니다. 핵심 트윈 메소드(gsap.to, from, fromTo, set), 일반 변수(duration, delay, ease, stagger, repeat 등), CSS 및 transform 속성 매핑, 함수 기반 값, 내장 이징 함수 등을 다룹니다. 또한 gsap.timeline()을 사용한 타임라인 생성, position 매개변수를 통한 정밀한 시퀀싱, 레이블, 중첩 타임라인, 재생 제어 메소드에 대해 자세히 설명합니다. matchMedia()를 사용한 반응형 및 접근성 설정, will-change와 transform을 통한 성능 최적화 기법, 빈번한 업데이트를 위한 gsap.quickTo(), stagger 활용법이 포함되어 있습니다. Claude Code, Cursor, Codex 등 모든 주요 AI 코딩 에이전트와 함께 작동하도록 설계되었으며, AI가 HyperFrames에서 부드럽고 성능이 뛰어난 애니메이션을 생성할 수 있도록 일관된 camelCase 속성명 사용, layout 속성보다 transform 우선, 적절한 정리 등의 모범 사례를 강조합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/assafkip/claude-video-editor/tree/HEAD/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로 설정하세요.

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()로 레이블을 추가하여 가독성 높은 시퀀싱을 만드세요.
  • 타임라인 생성자에 기본값을 전달하세요.
  • 재생 제어가 필요할 때는 트윈/타임라인의 반환 값을 저장하세요.

하지 말 것

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

Individual skills in this repo

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

assafkip/claude-video-editor

Build videos from stills when there is nothing to cut — narration first (ElevenLabs v3 with audio tags), then still keyframes from ANY source (AI image tools, screenshots, photos, HyperFrames-rendered HTML), animated deterministically with the animate-stills recipe (HyperFrames camera moves + GSAP atmosphere). Use when the user wants an explainer, documentary-style video, or any video built from generated or collected visuals instead of recorded footage.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

Beginner-friendly end-to-end video creator for HyperFrames. Use when the user says "make a video", "create a video", "new video", "build a video", "video from scratch", "I want to make a video", "help me create a video", or when someone who's never used HyperFrames before arrives with a concept, script, or rough idea and wants a finished MP4. Interviews the user in one pass, then builds the full video with mandatory preview and visual-verification gates.

assafkip/claude-video-editor

Build and iterate short-form vertical (9:16) videos in Hyperframes — TikTok/Reels/Shorts style. Use when Nate says "short-form video", "vertical video", "TikTok/Reels/Shorts", "make a short", "talking-head + motion graphics", or when the target is a 1080x1920 composition with face video + synced scene overlays + karaoke captions. Encodes the full May Shorts 19 playbook: face-mode choreography, audio-synced scene timing, karaoke captions, and the 10-rule quality checklist.

assafkip/claude-video-editor

Edit any video by conversation — the orchestrator for the bundled video pipeline. Use when the user wants to edit, cut, caption, grade, or add motion graphics to footage; drops a folder of clips and says "edit this"; or asks to make a promo/teaser/tutorial/short. Routes to video-use (the cut engine) and HyperFrames (motion-graphics overlays), with a motion-craft library for taste.

assafkip/claude-video-editor

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.

assafkip/claude-video-editor

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.

관련 스킬