사용 가이드로 건너뛰기
gsap-timeline작성자 GreenSock

GSAP Timeline 스킬.

Claude Code 및 Codex를 위한 모션 및 비디오 스킬: GSAP 타임라인: position 매개변수, 중첩 및 재생 제어.

  • Motion & Video
  • UI 코드
greensock/gsap-skills · skills/gsap-timeline/SKILL.mdSKILL.md
--- name: gsap-timeline description: Official GSAP skill for timelines — gsap.timeline(), position parameter, nesting, playback. Use when sequencing animations, choreographing keyframes, or when the user asks about animation sequencing, timelines, or animation order (in GSAP or when recommending a library that supports timelines). --- ## When to Use This Skill ## Creating a Timeline ## Position Parameter ## Timeline Defaults ## Timeline Options (constructor) ## Labels
2026-09-14에 업스트림 파일에서 읽은 전문 및 섹션 제목 · 전체 4,338자

01 기능

Claude Code와 Codex에서 gsap-timeline Skill이 하는 일

요약, 워크플로, 산출물을 모두 해당 스킬의 SKILL.md에서 그대로 읽어 정리한 내용입니다.

SKILL.md에서2026-09-14 읽음 · 실행 기록 아님

스킬 자체의 표현으로

gsap.timeline()으로 애니메이션을 시퀀싱하는 공식 GSAP 스킬입니다. 타임라인을 생성하고, 기본적으로 순서대로 추가되는 트윈을 연결한 다음, position 파라미터로 위치를 재조정하는 방법을 다룹니다 — 절대 초 단위, 상대 오프셋("+=0.5"/"-=0.2"), 레이블, 그리고 "<"/">" 배치입니다.

타임라인 생성자 옵션(paused, repeat, yoyo, onComplete/onStart/onUpdate, defaults), addLabel()을 이용한 레이블링과 play()/tweenFromTo()를 이용한 탐색, 마스터 타임라인에 자식 타임라인을 중첩하는 방법, 그리고 restart, time, progress, kill을 포함한 재생 메서드를 설명합니다. 마지막으로 GSAP 모범 사례와 피해야 할 함정을 다루는데, 특히 delay를 사용한 체이닝과 타임라인 내부의 트윈에 ScrollTrigger를 적용하는 것에 주의해야 합니다.

산출물

  • 변수에 저장된 타임라인 객체로, 모든 예제에서 tl로 표기되며 연결된 트윈이 추가되고 재생 메서드가 작동하는 대상입니다.
  • tweenFromTo가 반환하는 새 트윈으로, 타임라인이 일시정지된 상태에서 이즈 없이 두 레이블 사이를 재생 위치를 애니메이션합니다.
  • 종료된 타임라인: kill()을 호출하면 타임라인이 제거되며, 기본적으로 그 자식들도 함께 제거됩니다.
예시 프롬프트 보기 ↗

작동 방식

  1. 01
    타임라인 생성 및 트윈 연결

    gsap.timeline()을 호출하고 .to() 호출을 연결하십시오. 위치를 지정하지 않으면 각 트윈은 이전 트윈이 끝난 후에 추가되므로, 작성한 순서가 곧 재생 순서가 됩니다.

  2. 02
    각 트윈을 시간상에 배치하기

    배치는 세 번째 인자나 vars의 position 속성으로 설정됩니다: 절대 초 단위, 상대 오프셋, 레이블 이름, 또는 가장 최근에 추가된 애니메이션을 기준으로 한 < 및 >입니다.

  3. 03
    타임라인에 공유 기본값 부여하기

    타임라인 생성자에 전달된 기본값은 모든 자식 트윈에 병합되므로, duration과 ease를 전체 시퀀스에 대해 한 번만 선언하면 됩니다.

  4. 04
    주요 지점에 레이블 지정하기

    addLabel()은 타임라인 내 특정 시점에 이름을 붙이며, 이후 트윈은 숫자 대신 이 레이블을 위치 타겟으로 사용할 수 있습니다.

  5. 05
    마스터 타임라인 안에 타임라인 중첩하기

    마스터 타임라인은 자식 타임라인을 하나의 단위로 받아 특정 시점에 배치할 수 있으며, 이후 트윈은 이를 기준으로 상대적으로 추가됩니다.

  6. 06
    전체 시퀀스를 한 번에 제어하기

    타임라인이 구성되면 트윈 단위가 아니라 하나의 단위로 재생 및 일시정지됩니다.

02 적합성 확인

gsap-timeline 스킬 사용 시점

이러한 종류의 모션 및 비디오 작업이 필요할 때 Claude Code 또는 Codex에서 gsap-timeline 스킬을 사용하십시오. 적합성과 제한사항은 스킬 자체 파일에서 가져왔습니다.

적합한 경우

  • 여러 트윈이 순차적으로 또는 동시에 실행되어야 하는 다단계 애니메이션을 구성하는 경우.
  • 사용자가 GSAP에서 타임라인, 시퀀싱, 또는 키프레임 방식의 애니메이션에 대해 질문할 때.
  • 스크롤로 구동되는 타임라인이며, 이 파일은 scroll-trigger 스킬과 함께 사용됩니다.

한계 인지하기

  • 단일 트윈이나 이즈 하나만 다루는 경우는 범위 밖이며, 이 파일은 이를 core 스킬로 안내합니다.

제공할 사항

  • 각 자식 트윈의 타겟과 vars체이닝된 각 .to() 호출은 셀렉터와 vars 객체를 받으며, 타임라인은 이들을 하나의 시퀀스로 구성합니다.
  • 타임라인 레벨의 repeat와 yoyorepeat와 yoyo는 트윈에서와 동일하게 동작하지만 개별 트윈이 아니라 타임라인 전체에 적용됩니다.
  • 타임라인 레벨의 콜백onComplete, onStart, onUpdate는 타임라인 레벨에서 전달되므로 시퀀스 전체에 대해 발생합니다.

03 스킬 내부

gsap-timeline 스킬이 Claude Code와 Codex에 제공하는 규칙

SKILL.md가 에이전트에게 설정하는 8가지 구체적인 지시, 기본값, 제한 — 결과를 바꾸는 파일의 부분입니다.

  1. delay로 체이닝하지 않기

    타임라인으로 순서를 지정할 수 있는 경우 delay로 애니메이션을 체이닝하지 마십시오. 이 파일은 다단계 애니메이션에 대해 gsap.timeline()과 position 매개변수를 사용하도록 안내합니다.

  2. 추측보다 position 매개변수 사용하기

    트윈을 특정 시점에 배치하거나 레이블 기준 상대 위치에 배치할 때는 항상 세 번째 인자인 position 매개변수를 사용하십시오.

  3. 레이블에 이름 붙이기

    시퀀싱이 읽기 쉽고 유지보수 가능하도록 addLabel()로 레이블을 추가하십시오.

  4. 생성자에 기본값 지정하기

    자식 트윈이 duration, ease 등의 vars를 트윈마다 반복하지 않고 상속받도록 타임라인 생성자에 defaults를 전달하십시오.

  5. ScrollTrigger는 타임라인에 배치하기

    ScrollTrigger는 타임라인 또는 최상위 트윈에 배치하고, 타임라인 내부의 개별 트윈에는 배치하지 마십시오.

  6. ScrollTrigger 애니메이션은 절대 중첩하지 마십시오

    ScrollTrigger를 포함한 애니메이션은 중첩해서는 안 됩니다. ScrollTrigger는 오직 최상위 Tween 또는 Timeline에만 위치해야 합니다.

  7. 생성자의 Duration은 시퀀스 길이가 아닙니다

    타임라인 생성자의 duration을 트윈 duration으로 읽어서는 안 됩니다 — 문서에서는 이를 흔한 실수라고 지칭합니다.

  8. 기본 배치 방식을 알아두십시오

    ">"는 방금 추가된 애니메이션이 끝날 때 트윈을 시작하며 기본 배치 방식이고, "<"는 해당 애니메이션의 시작점에 맞춥니다.

04 활용하기

Claude Code 또는 Codex에 gsap-timeline 설치

npx skills add 명령 한 번 실행 후, 에이전트에서 첫 번째 작업을 수행하고 결과 체크리스트를 확인합니다.

Claude Code, Codex 또는 사용자의 에이전트에 gsap-timeline 추가

프로젝트에서 실행합니다. 설치 프로그램이 어떤 에이전트에 추가할지 묻습니다.

Terminal
npx skills add https://github.com/greensock/gsap-skills --skill gsap-timeline

skills/gsap-timeline/SKILL.md에 대한 일반적인 skills CLI 형식이며, 저장소가 자체 경로를 문서화할 수도 있습니다.

스킬에 첫 번째 모션 및 비디오 작업 제공

스킬 자체의 용어로 작성되었습니다. 대괄호 부분은 각자의 자료로 교체합니다.

Starter prompt
I'm sequencing a [hero banner] animation: [the headline] slides up, then [the CTA button] appears 0.5s later, and [the product shot] scales in at the same start time as the button. I want shared duration and ease defaults on the timeline, and labels for the intro and outro so I can play from either one.

출처: 스킬 자체의 용어로 SKILL.md에서 작성했습니다.

첫 번째 결과 확인

SKILL.md 자체가 올바른 결과의 모습으로 제시하는 내용:

  • tl.time(2)로 재생 위치를 특정 시점으로 이동시켜 각 트윈이 position 매개변수가 의도한 지점에서 시작하는지 확인합니다.
  • 기본값이 실제로 자식들에게 적용되었는지 확인합니다: 문서의 예시에서는 두 트윈 모두 0.5s와 power2.out을 반복 지정하지 않고 사용합니다.
  • 레이블 이름부터 재생하여 해당 레이블이 예상한 시점에 추가되었는지 확인합니다.
  • 시퀀스를 역방향으로 미리 보려면 reverse를 사용합니다. 문서에서는 progress(1) 이후 reverse()를 호출하여 타임라인이 완전히 역방향으로 재생되도록 합니다.

OpenDesign에서는 gsap-timeline이 기본 포함되어 있습니다: Plugins → Skills에서 상단 바에서 선택하십시오.

05 오픈 소스, 추적 가능

출처, 라이선스 및 검증

이 페이지의 사실이 어디에서 왔으며 언제 마지막으로 확인되었는지 안내합니다.

Author
GreenSock
Repository
github.com/greensock/gsap-skills 브랜치 main
스킬 파일
skills/gsap-timeline/SKILL.md 검증 시 기록된 콘텐츠 체크섬, 커밋 aed9cfd
License
MIT LICENSE에서 가져옴; SKILL.md에 "MIT"로 표기됨.
리포지토리 스타
15,248 이 카탈로그에 8개의 스킬을 포함하는 전체 greensock/gsap-skills 리포지토리에 대해 2026-09-14에 촬영된 GitHub 스냅샷입니다. gsap-timeline에 대한 평가 또는 사용 수가 아닙니다.
OpenDesign에서 검증됨
2026-09-14 소스 파일, 경로, 라이선스 텍스트 및 별 개수가 확인되었습니다. OpenDesign 메인에 번들로 포함됨(2026-08-28 확인됨); 이 페이지에 실시간 실행이 기록되지 않았습니다.

SKILL.md 내부

  1. 이 Skill을 사용해야 하는 경우다단계 애니메이션 및 시퀀싱에 적용되며, 핵심(core), scroll-trigger, React 스킬을 상호 참조합니다.
  2. 타임라인 생성하기gsap.timeline()에 .to() 호출을 연결합니다. 재배치하지 않으면 트윈은 기본적으로 순서대로 추가됩니다.
  3. Position 매개변수세 번째 인자 또는 vars 속성: 절대값, 상대 오프셋, 레이블, 그리고 꺽쇠 괄호를 이용한 배치.
  4. 타임라인 기본값타임라인 생성자에 전달된 기본값은 모든 자식 트윈에 상속됩니다.
  5. 타임라인 옵션(생성자)paused, repeat, yoyo, 타임라인 수준의 콜백, 그리고 자식에게 전달되는 defaults 객체.
  6. 레이블addLabel()을 사용한 뒤, play()와 tweenFromTo()로 레이블이 지정된 지점부터 시작합니다.
  7. 타임라인 중첩master.add(child, 0)을 통해 마스터 타임라인이 자식 타임라인을 포함할 수 있습니다.
  8. 재생 제어하기타임라인에 대해 play, pause, reverse, restart, time, progress, kill이 나열되어 있습니다.
  9. 공식 GSAP 모범 사례다섯 가지 체크 표시 사례: delay보다 타임라인 사용, position 매개변수, 레이블, defaults, 최상위 ScrollTrigger.
  10. 하지 말아야 할 것delay 체이닝, defaults 생략, ScrollTrigger 중첩을 포함한 네 가지 X 표시된 실수.
스킬 자체 설명
"타임라인을 위한 공식 GSAP 스킬 — gsap.timeline(), position 파라미터, 중첩, 재생. 애니메이션 시퀀싱, 키프레임 조정 또는 사용자가 GSAP에서 애니메이션 시퀀싱, 타임라인 또는 애니메이션 순서에 대해 질문할 때(또는 타임라인을 지원하는 라이브러리를 권장할 때) 사용합니다."

SKILL.md의 front-matter 설명입니다. 전체 파일은 약 4,338자입니다. GitHub에서 전체 파일 읽기.

06 설치하기 전에

gsap-timeline Skill에 관한 질문

이 답변은 2026-09-14 기준으로 확인한 SKILL.md 내용을 근거로 하며, 실행 기록을 바탕으로 한 것이 아닙니다.

트리거하기 전까지 시작하지 않는 타임라인은 어떻게 만드나요?

생성자에 paused: true를 지정해 타임라인을 일시정지 상태로 두고, 실행하고 싶을 때 .play()를 호출하세요.

GSAP Timeline

실제 모션 및 비디오 작업에서 gsap-timeline 실행

gsap-timeline 스킬은 OpenDesign에 내장되어 있습니다. 앱을 다운로드하고 Plugins → Skills에서 스킬을 선택한 후 위의 프롬프트를 붙여넣고 결과 전에 계획을 읽으십시오.

터미널
npx skills add https://github.com/greensock/gsap-skills --skill gsap-timeline