Communitygithub.com

모션 언어

에이전트가 '모션 언어'로 계획, 제작, 편집하여 최종 결과물이 사용 가능한 카피나 스크립트가 되도록 안내합니다. 이 절차는 모션 언어, 중요한 한 가지 구분, 어휘를 통해 진행됩니다. 새로운 작업에서 이 기술이 필요할 때 사용하세요.

모션 언어란 무엇인가요?

이 스킬은 AI 에이전트가 동영상 제작을 위한 모션 언어(모션 그래픽 디자인 언어)를 계획하고 구축하거나 편집할 수 있도록 설계된 전문 지침입니다. '스팅어(stinger)'와 '씬(scene)'이라는 두 가지 핵심 개념을 엄격히 구분하며, 스팅어는 2~4초의 짧은 길이로 하나의 아이디어를 제스처처럼 전달하는 반면, 씬은 8~15초 동안 논증을 전개합니다. 이 스킬은 다섯 가지 기본 요소(ground, glass, sheen, path, state)로 구성된 어휘를 정의하고, converge, overload, steps 등 구체적인 스팅어 종류와 그 사용법을 JSON 형식으로 제공합니다. Claude Code, Cursor, Codex 등 다양한 AI 코딩 도구에서 사용할 수 있으며, SKILL.md 문서를 통해 에이전트가 일관된 모션 디자인 시스템을 따르도록 안내합니다. 또한 B-roll(전면 재생)과 인용(카드 내 표시)의 차이를 명확히 하고, 외부 블록 레지스트리나 hyperframes-animation 스킬과의 연계를 통해 더 풍부한 모션을 구현할 수 있습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

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

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

문서

모션 언어은(는) 무엇을 하나요?

skills/00-house-rules/SKILL.md를 상속받습니다. 구현체는 scripts/stingers.py이며, 모든 스팅어를 렌더링하는 갤러리는 scripts/build_stinger_gallery.py입니다.


중요한 한 가지 구분

씬은 설명합니다. 스팅어는 제스처합니다.

씬스팅어
길이8–15초2–4초
전달읽어야 하는 논증이미 들은 하나의 아이디어
얼굴숨김 또는 PiP숨김 — 스팅어로 컷합니다
개수10분 동영상에 3–6개20–40초마다 하나
제거 시요점이 전달되지 않음동영상이 평평해지지만, 틀리지는 않음

이것을 뒤집는 것이 흔한 실패입니다. 실제 내용이 있는 세 항목 목록은 compare 씬이고, 동일한 목록을 steps로 처리하면 장식에 불과합니다. 시청자가 읽어야 한다면 그것은 스팅어가 아닙니다.

스팅어는 위에 겹치는 것이 아니라, 스팅어로 컷합니다. 몇 초 동안 프레임을 차지합니다. 화자가 뒤에 보이는 전체 프레임 그래픽은 실수로 읽히며, 3초 동안 얼굴이 없어도 아무 손해가 없습니다.


어휘

다섯 가지 요소. 라이브러리의 모든 것은 이들의 조합이며, 이것이 서로 관련 없는 애니메이션이 하나의 시스템으로 읽히는 이유입니다.

ground부드러운 방사형으로 밝아진 거의 검은색. 절대 평평한 #000이 아닙니다 — 진짜 검은색 프레임은 디자인이 아닌 신호 끊김으로 읽힙니다.
glass약 4.5% 잉크의 반투명 채움, 약 14%의 1px 테두리, 반경 26. 깊이는 테두리와 내부 하이라이트에서 오며, 절대 카드에 그림자를 넣지 않습니다.
sheen카드가 안착할 때 카드를 가로지르는 낮은 각도의 반사광. 이것이 시그니처 움직임입니다 — 평평한 직사각형을 물리적 물체로 읽히게 만듭니다.
path약 10% 잉크의 얇은 점선 곡선. 물체는 경로를 따라 이동합니다. 아무것도 순간이동하지 않습니다.
state시스템 상태를 전달하는 작은 점들의 행. 그 행의 색상 변화는 한 줄의 카피 없이 "그리고 나서 고장 났다"고 말합니다.

간격은 120–160ms입니다. 100ms 미만이면 형제 요소가 하나의 객체로 읽히고, 200ms를 초과하면 시청자가 기다리기 시작합니다.

모든 스팅어는 마지막 프레임을 유지합니다. 음성에 맞춰 컷되므로, 페이오프 이후의 어떤 프레임에서 끝나도 안전해야 합니다. 반복되는 것은 없습니다. 빈 무대에서 끝나는 것도 없습니다.


라이브러리

{ "kind": "converge", "from": "모든 것이 한 곳으로 모인다", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
kind속하는 문장dur
converge"이 모든 것이 한 곳으로 모입니다." 칩이 점선 경로를 따라 빛나는 코어로 이동하고, 로드가 걸리면서 상태 점이 채워집니다.3.0–3.6
overload"그리고 나서 작동을 멈췄습니다." 동일한 코어가 붉게 갈라집니다. converge의 지오메트리를 공유하여 두 개가 하나의 이야기로 함께 컷됩니다.2.4–3.0
steps"이것 중 세 가지가 있습니다." 번호가 매겨진 유리 카드, 간격을 두고, 각각에 sheen. 가장 재사용 가능하고 가장 남용됩니다.2.6–3.2
swap"이것이지, 저것이 아닙니다." A는 취소선이 그어지고 위로 사라집니다. B가 그 아래에 도착합니다. 둘 다 읽을 수 있습니다.3.0–3.6
countup"43퍼센트였습니다." 숫자가 오르고, 값에 따라 크기가 커지며, 보이는 소스 라인 위에 표시됩니다.2.6–3.4
beats세 개의 짧은 구문, 타악기처럼. 각각 하나의 공유된 비트 그리드에서 다른 시작 동작을 가집니다.2.4–3.2
surround"도구에 파묻혔습니다." 레이블이 붙은 칩이 고정된 중심을 감싸다가 좁혀집니다. 중심은 절대 움직이지 않습니다.3.2–4.0
photo처리된 발견된 이미지. 유리 카드, 느린 Ken Burns 효과, 캡션, 크레딧 라인.2.8–4.0
clip정지 이미지 대신 푸티지를 담는 동일한 카드. Ken Burns 없음 — 이미 움직이기 때문입니다.2.4–3.0

composition.json에서 씬과 정확히 동일하게 사용하세요 — 동일한 from / at / dur 앵커링, 구문이 해석되지 않으면 동일한 하드 오류가 발생합니다.


B-roll: photo / clip 스팅어

두 가지 처리 방식, full이 그중 하나를 선택합니다. full은 옵트인입니다. 생략하면 카드가 적용됩니다.

full: true — B-ROLLfull: false — 인용
프레임전체 채움, 카드 없음유리 카드, sheen, 느린 드리프트
프레임 위 텍스트샷이 무엇인지 명명하는 하단 1/3캡션 및 크레딧 라인
프레임 위 소스절대 없음필수
사용처순간을 전달하는 푸티지 및 정지 이미지스크린샷, 차트, 가격 페이지, 문서

B-roll은 전체 화면이며 소스 참조를 표시하지 않습니다. 사람의 상시 지시, 2026-08-14. 누구나 본 모든 편집에서 B-roll이 그렇듯 전체 프레임을 차지합니다. 프레임 위에 허용되는 유일한 텍스트는 샷이 무엇인지 말하는 하단 1/3이며, 어디서 왔는지는 절대 아닙니다. 속성 표시는 여전히 이루어집니다 — 드롭의 _FINAL/ATTRIBUTION.md에서, fetch_stock.py가 다운로드 시 작성하며 어떤 편집도 건너뛸 수 없습니다. Pexels와 Pixabay 모두 프레임 내 크레딧을 선택 사항으로 만들므로, 원장은 라이선스를 자체적으로 충족시키고 프레임은 깔끔하게 유지됩니다.

이것은 B-roll에 대해 여기에 있던 이전 단락을 대체합니다. 이전 단락은 전체 채움 클립이 "다른 동영상으로 읽힌다"고 주장하며 모든 것을 카드에 넣었습니다. 그 추론은 인용의 경우에만 여전히 유효합니다. 시청자가 인용하는 증거로 자산을 읽도록 의도된 경우, full: false와 소스 라인이 프레임으로 돌아갑니다.

빌더는 여전히 카드를 기본값으로 하며, 이는 의도적입니다. 기본값을 뒤집으면 이미 작성된 모든 photo 씬을 조용히 다시 처리하게 됩니다(drop-005의 working/stingers/plan.json 포함). 어제 카드를 렌더링한 사양은 오늘도 동일한 카드를 렌더링해야 합니다. 새 작업은 "full": true를 요청합니다. skills/executive-animator는 항상 그렇게 합니다. 카드가 완전히 폐기된다면 st_photo에서 한 단어만 변경하면 됩니다.

하나의 지오메트리 참고 사항: 전체 채움은 object-fit: cover를 사용하므로 이미 16:9인 소스를 제공하세요. 전체 프레임에 표시된 2.19:1 크롭은 각 측면에서 221px을 잃어버리며, 이로 인해 모든 게이트가 올바른 박스를 보고하는 동안 다이어그램의 첫 번째와 마지막 열이 잘려나가는 결과가 발생합니다.

하나의 빌더, 두 개의 이름. 정지 이미지는 photo, 푸티지는 clip입니다. 파일 확장자에서 분기하므로 이름은 사양을 읽기 쉽게 만들기 위해서만 존재합니다. 실제로 변경되는 사항:

photoclip
요소<img>프레임워크 타이밍의 <video muted playsinline>
Ken Burns예, 카드 전체에 걸쳐 1.00 → 1.07없음

푸티지에는 Ken Burns가 없습니다. 클립이 자체 모션을 제공하며, 실제 모션 위에 스케일 램프를 추가하는 것은 정확히 스톡을 스톡처럼 읽히게 만드는 요소입니다. 정지 이미지는 움직임이 없으며 살아 있기 위해 드리프트가 필요합니다. 클립은 그렇지 않습니다.

// B-roll. 전체 화면, 하단 1/3은 무엇인지 표시, 프레임에 소스 없음.
{ "kind": "clip", "from": "모든 것이 동시에 움직이고 있다", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "모든 것이 동시에 움직임" }

// 인용. 시청자가 증거로 읽는 문서이므로 카드와 크레딧이 돌아옵니다.
{ "kind": "photo", "full": false, "from": "가격 페이지가 변경되었다", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Anthropic 가격, 2026년 8월",
  "credit": "ANTHROPIC.COM · 가져옴 2026-08-13" }

하단 1/3는 cap_left / cap_bottom에 위치하며, 기본값은 96 / 186 — 가로로, youtube_long의 96 왼쪽과 132 아래쪽을 비웁니다. 9:16 호출자는 자체 cap_bottom을 전달해야 합니다. 릴스는 아래쪽에 520을 예약하고 가라오케 밴드는 y 1150-1400을 차지하므로 가로 기본값은 진행 표시줄 아래에 캡션을 배치합니다. 두 프레임 모두에 맞는 쌍은 없습니다.

src는 사양 파일을 기준으로 해석되며 빌더가 프로젝트의 assets/로 복사하므로, 잘못된 경로는 빌드 시 빈 카드가 아닌 큰 소리로 실패합니다. 둘 다 scripts/fetch_stock.py에서 가져오며, 이 스크립트는 붙여넣을 준비가 된 블록을 출력합니다.

속성 표시는 프레임 의무가 아니라 원장 의무입니다. 모든 티어 3 자산은 드롭의 _FINAL/ATTRIBUTION.md에 행을 얻습니다. 이 파일은 fetch_stock.py가 다운로드 시 작성합니다 — 이것이 config/broll-policy.md가 요구하는 사항이며 선택 사항이 아닙니다. 크레딧이 프레임에 또한 표시되는지는 디자인 결정이며, B-roll의 경우 답은 '아니오'입니다. 인용 카드에서는 유지되며 WCAG AA로 렌더링됩니다. 아무도 읽을 수 없는 속성 표시는 속성 표시가 아닙니다.

먼저 티어 순서로 모든 이미지를 해결하세요. 사진은 티어 3입니다. 자신의 푸티지와 티어 2 오버레이가 모두 진정으로 아무것도 없을 때에만 사용하세요. Ken Burns 효과는 클리핑 카드 내부의 <img>에서 실행되며, 카드 자체에서는 실행되지 않습니다.

⚠ 긴 타사 비디오 삽입 패턴을 복사하지 마세요. 이 언어가 참조하는 원본은 50초 분량의 다른 사람의 인터뷰 푸티지를 실행합니다. config/broll-policy.md는 이를 완전히 금지하며, 아무리 좋은 모션 디자인이라도 그것을 우리의 것으로 만들지 않습니다. 속성 표시가 있는 사진은 괜찮습니다. 비디오의 절반을 가져오는 것은 안 됩니다.


더 넓은 메뉴 — 위의 항목이 맞지 않을 때 선택할 것

두 개의 상위 코퍼스가 존재하며 둘 다 이 라이브러리보다 큽니다. 모션을 새로 발명하기보다는 이들로부터 읽어 들이세요.

hyperframes-animation 스킬 — 48개의 원자적 규칙 + 22개의 씬 청사진. Skill(hyperframes-animation)으로 로드한 다음 rules-index.md를 열고 rules/<name>.md에서 필요한 하나의 규칙을 읽으세요. 하우스 기본값은 일시 중지된 하나의 타임라인에 2–4개의 원자적 규칙을 구성하는 것입니다. 청사진은 전체 4–5단계 샷을 원할 때 사용합니다.

블록 레지스트리 — 373개의 설치 가능한 블록: npx hyperframes catalog --query "<개념>", 그 다음 npx hyperframes add <블록>.

상황 → 규칙

토크쇼 설명자를 위해 선별되었습니다. 이 규칙들은 우리 형식에서 살아남습니다. 나머지 48개는 대부분 제품 UI 또는 우리가 가지고 있지 않은 구동 커서를 가정합니다.

라인이 다음과 같을 때...규칙이유
숫자, 통계, 백분율counting-dynamic-scale, stat-bars-and-fills이미 countup으로 구현됨. 막대, 링, 별 채우기에는 규칙을 직접 사용하세요.
펀치 있는 목록, 빠른 연속kinetic-beat-slam, waterfall-entrybeats로 구현됨. waterfall-entry는 더 부드러운 캐스케이드입니다.
정의 또는 용어 등장gradient-text-sweep, depth-scatter-assemble첫 번째에서는 글리프가 절대 움직이지 않습니다. 두 번째는 깊이에서 조립합니다.
"여기 그 모양이 있습니다" (다이어그램)svg-path-draw윤곽선이 스스로 그려집니다. 설정 시 getTotalLength()로 측정하세요.
"그것은 둘러싸여 / 파묻혀 / 연결되어 있습니다"radial-surround, avatar-cloud-network, orbit-3d-entrysurround로 구현됨. 다른 두 개는 연결선과 3D 진입을 추가합니다.
하나의 아이디어가 다른 아이디어를 대체scale-swap-transition, card-morph-anchor, morph-swapswap으로 구현됨. card-morph-anchor는 컨테이너 자체를 변형합니다.
"이것을 자세히 보세요"depth-of-field-blur, coordinate-target-zoom, viewport-change랙 포커스 또는 .world 래퍼의 가상 카메라.
말한 단어 강조asr-keyword-glow, css-marker-patterns단어 타임스탬프와 동기화된 글로우 — 우리는 이미 측정된 단어 시간을 가지고 있습니다.
강하고 타악기적인 악센트chromatic-glitch, particle-burst, motion-blur-streak아껴서 사용하세요. 동영상당 최대 하나.
차분한 착지 비트titlecard-reveal (청사진), ambient-glow-bloom적은 모션이 결함이 아니라 페이로드입니다.
어떤 시작 동작이든spring-pop-entrance표준 팝. 의심스러우면 이것.

알아 둘 가치가 있는 청사진

22개 중 대부분은 제품 출시 광고 형태입니다. 4개가 우리가 실제로 만드는 것에 매핑됩니다:

  • kinetic-type-beats — 작업 마차. 단어가 샷을 전달합니다. 세트도 표면도 없습니다.
  • dataviz-countup — 데이터가 논증을 전달할 때.
  • comparison-split — 두 가지 능력을 동시에 비교합니다 (우리의 compare 씬은 평평한 사촌입니다).
  • titlecard-reveal — 숨 고르기 비트, 정확히 하나의 절제된 움직임.

건너뛰세요 cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate 및 실제 제품 UI를 보여주는 경우가 아니라면 나머지 데모 계열. 그것들은 훌륭하지만 우리 형식이 아닙니다 — 갑자기 가짜 앱 데모를 수행하는 토크쇼 설명자는 광고로 읽힙니다.

모든 상위 규칙이 가정하는 계약

하나를 복사하기 전에 알아 둘 가치가 있습니다. 이를 위반하면 검사가 실패하지 않고 렌더링이 실패합니다:

  • window.__timelines에 하나의 일시 중지된 GSAP 타임라인. 절대 자동 재생 금지, 절대 두 번째 타임라인 금지.
  • 양방향 탐색 안전 — 명시적인 from 상태, 절대값, 절대 상대적인 +=가 없는 fromTo. 상태는 타임라인 시간의 순수 함수여야 합니다.
  • 결정론적 — Math.random() 또는 Date.now() 사용 금지. 인덱스에서 파생된 의사 난수만 허용. 유한 반복, 절대 repeat: -1 금지.
  • 변환 및 페인트만 허용. width / height / top / left 트윈은 금지됩니다. scale/translate 프록시 또는 마스크를 사용하세요.
  • 그룹 간격은 도착이 하나의 비트로 읽히도록 제한됩니다 — 항목 × 간격 ≤ ~0.5초.
  • 레이아웃 상수를 미리 계산하세요. 트윈 시간에 위치를 도출하지 마세요. 렌더러는 병렬로 샘플링하며 측정값이 동기화되지 않습니다.

새 개념 추가

  1. 먼저 레지스트리를 검색하세요 — npx hyperframes catalog --query "<개념>". 373개의 블록이 존재합니다. radial-surround, morph-swap, split-tilt-cards 및 particle-image-reveal은 이 라이브러리의 것들과 가까운 사촌이며 새 코드보다 더 나은 시작점이 될 수 있습니다.
  2. 위의 다섯 가지 요소로 구축하세요. 여섯 번째 요소가 필요한 개념은 씬이거나, 어휘에 의도적인 확장이 필요하다는 신호입니다 — 예외가 아닙니다.
  3. scripts/stingers.py의 KINDS에 추가하세요.
  4. 갤러리를 렌더링하고 모든 것을 함께 보세요. 그것이 새로운 것이 패밀리에 합류했는지 아니면 단지 옆에 착륙했는지 알 수 있는 유일한 방법입니다.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

이 라이브러리가 이미 발견한 세 가지 결함

각각은 누군가 프레임을 보기 전에 깨끗한 hyperframes check를 통과했습니다:

  1. GSAP은 ::after를 애니메이트할 수 없습니다. querySelector로 대상을 해석하는데, 이는 절대 의사 요소를 반환하지 않으므로 모든 sheen이 조용히 아무것도 하지 않았습니다. 이제 sheen은 실제 자식 요소(SHEEN_EL)입니다. 카드를 추가한다면 내부에 넣으세요.
  2. GSAP은 문자열에서 원시 CSS 변수로의 트윈(예: boxShadow: "0 0 0 var(--color-primary)")을 지원하지 않습니다. window.getComputedStyle(el).getPropertyValue("--color-primary")를 사용하여 런타임에 확인하세요.
  3. GSAP의 'from' 트윈은 대상의 애니메이션 가능한 속성을 계산 대상 속성으로 간주합니다. 처음에 숫자 값이 없는 속성(예: 빈 문자열의 opacity)은 "from" 상태가 올바르게 설정되지 않습니다. from 상태를 명시적으로 설정하는 것은 단순히 기본값에 의존하는 것보다 안전합니다.

Individual skills in this repo

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

관련 스킬