Communitygithub.com

atmirrr/persian-motion-director

페르시아어/파르시어 및 오른쪽에서 왼쪽(RTL) 타이포그래피를 포함한 전문 모션 디자인(프로모션 및 론칭 필름, 키네틱 타이포그래피, 애니메이션 설명 영상, 소셜 클립, 타이틀 시퀀스)을 Remotion 또는 일반 웹 코드로 제작하고 감독합니다.

persian-motion-director란 무엇인가요?

이 스킬은 AI 생성 모션 그래픽이 흔히 보이는 '슬라이드쇼' 방식(모든 장면이 페이드 인/아웃되고 모든 요소가 동일한 이징으로 등장)과 깨진 페르시아어 문자(글자가 분리되거나 점이 잘리고 아랍어 문자가 잘못 사용됨)라는 두 가지 문제를 동시에 해결합니다. 전문 모션 디자이너의 실제 작업 방식을 기반으로 한 '안티-슬라이드쇼' 방법(하나의 카메라, 장면 간 공유 오브젝트, 음악 우선 비트 기반 편집)을 제공하며, HarfBuzz를 활용한 글자별/점별 페르시아어 애니메이션, 카시다(kashida) 늘리기, 페르시아어 정확성 검사 린터 등 8가지 준비된 기법을 포함합니다. Remotion과 일반 웹 코드를 모두 지원하며, 브리핑 분석부터 방향 제시, 음악 선정, 스타일 프레임, 최종 점검까지의 완전한 워크플로우를 제공합니다. 페르시아어, 파르시어, 아랍어 문자 또는 RTL 텍스트가 포함된 비디오, 애니메이션, 모션 그래픽을 만들 때, 또는 결과물이 '기본적이다', '슬라이드쇼 같다', 'AI가 만든 것 같다', '전문적이지 않다'고 느껴질 때 혹은 페르시아어가 비정상적으로 보일 때 이 스킬을 사용해야 합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add atmirrr/persian-motion-director

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

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

문서

페르시아 모션 디렉터

당신은 단순히 애니메이션을 만드는 것이 아니라 감독하고 있습니다. 대부분의 생성형 모션은 두 가지 예측 가능한 방식으로 실패합니다: 슬라이드쇼처럼 재생되고(서로 페이드되는 장면, 모든 것에 동일한 ease-in-out, 모든 것이 동시에 도착함), 페르시아어가 깨집니다(글자가 분리되고, 점이 잘리며, 아랍어 문자와 숫자가 사용되고, 반각 공백이 누락되며, 왼쪽에서 오른쪽으로 나타납니다). 이 스킬은 두 문제를 모두 해결합니다. 이 방법은 전문 모션 디자이너들이 X에서 자신의 작업을 설명하는 방식에서 비롯되었으며, 페르시아어 규칙은 W3C의 아랍어 및 페르시아어 레이아웃 요구 사항을 기반으로 하고 Remotion이 렌더링하는 엔진인 Chrome에서 검증되었습니다.

감독의 루프

이 순서대로 작업하세요. 각 단계는 건너뛰면 결과물이 기본처럼 보이게 되기 때문에 존재합니다.

  1. 브리핑을 읽고 실제 공백만 채우세요. 텍스트(페르시아어 및 라틴어), 길이, 화면 비율, 브랜드 색상 및 글꼴, 게시 위치, 음악을 복사하세요. 브랜드가 있다면 새로운 것을 만들지 말고 해당 브랜드의 팔레트와 글꼴을 사용하세요.
  2. 제작 전에 방향을 보여주세요. 모션은 주관적이며 다시 작업하는 데 비용이 많이 듭니다. 아래 라이브러리에서 브리핑에 맞는 6~10개의 기법을 선택하고 assets/sketches/gallery.html을 열어(또는 클립을 렌더링하여) 사용자가 선택하도록 하세요. 전체 제작 후 재작업하는 것은 선택 목록보다 10배 더 많은 비용이 듭니다.
  3. 음악 먼저. 애니메이션을 시작하기 전에 트랙과 템포를 고정하세요. 바(bar) 맵을 만드세요: 각 섹션이 어떤 바에 위치하는지. 트랙이 없으면 하나를 작곡하거나(assets/music/compose_shur_pulse.py는 beats.json을 작성하는 작동 예제입니다) 요청하세요. 120 BPM에서 한 박자는 0.5초, 한 마디는 2초입니다. 60fps에서 한 박자는 30프레임입니다.
  4. 바 그리드에 샷 리스트를 작성하세요 (템플릿은 references/workflow.md에 있습니다). 모든 섹션 변경은 다운비트(downbeat)에 맞춰지고, 모든 컷은 박자 또는 그 2프레임 전에 맞춰집니다.
  5. 스타일 프레임. 4~6개의 스틸 이미지를 렌더링하고(assets/remotion/render-stills.mjs) 모든 것을 애니메이션화하기 전에 승인을 받으세요.
  6. 제작은 Remotion에서 하나의 카메라 컨테이너와 공유 오브젝트로 수행합니다(완전한 작업 예제는 assets/remotion/src/intro/Intro.tsx 참조).
  7. 점검 후 렌더링: 모든 텍스트에 대해 scripts/lint_persian.py를 실행하고, 잘린 점과 끊긴 연결을 확인하기 위해 전체 크기로 스틸 이미지를 검토하고, 모든 컷을 박자에 맞춰 꼼꼼히 확인하고, 루프가 정확한지 확인합니다(클립 길이 = 루프의 정수 배).

프로 모션을 슬라이드쇼와 구분하는 것

슬라이드쇼 습관대신 할 것
페이드 전환으로 연결된 장면들하나의 카메라가 장면 사이를 이동하거나, 하나의 오브젝트가 다음 장면으로 이어집니다. 장면 간에 절대 fade()를 사용하지 마세요.
모든 것에 동일한 ease-in-out각 움직임은 고유한 곡선을 가집니다. 진입: 약 20프레임에 걸쳐 bezier(.16,1,.3,1). 퇴장: 약 8프레임에 걸쳐 bezier(.7,0,.84,0), 약 70%만 이동합니다.
모든 것이 함께, 균일한 간격으로 도착하나의 주요 요소가 앞서고 나머지는 2~4프레임 뒤처지며, 균일하지 않고 곡선상에 배치됩니다.
Remotion의 기본 탄력적인 spring() (약 16% 오버슈트)UI에서는 2% 미만의 오버슈트, 텍스트에서는 없음: stiffness 100 / damping 16은 약 1.5%를 제공합니다.
마지막에 음악을 덧붙임음악 먼저; 박자에 맞춰 컷; 시각적 히트에 사운드 어택 배치.
그라데이션 위에 가운데 정렬된 텍스트, 끝에 로고처음 10초 안에 실제 제품이 실제 작업을 수행하는 모습을 보여주세요.
정지, 또는 멈춤이 없는 모션읽을 수 있을 만큼 충분히 유지; 카메라만 숨을 쉰다(장면당 zoom 1.00 → 1.04).
마감재로 그레인, 하프톤 또는 ASCII물리적인 이유(종이, 인쇄, 빛)가 있을 때만 텍스처를 사용하세요. 이러한 마감재는 이제 AI의 기본값입니다.

더 많은 숫자와 그 출처는 references/anti-slideshow.md에 있습니다.

페르시아어 불가결 사항

프레임에 페르시아어를 작성하기 전에 references/persian-typography.md를 읽으십시오. 짧은 버전:

  1. 페르시아어 글자를 절대 각자의 상자에 넣지 마십시오. inline-block 스팬, flex 자식(Remotion의 <AbsoluteFill>의 직계 자식 포함, 이는 flex 박스입니다) 및 모든 글자별 변환은 각 글자를 고립된 형태로 그립니다. 전체 단어나 줄을 애니메이션화하세요. 글자별 또는 점별 움직임이 정말로 필요할 때는 모양이 지정된 외곽선(scripts/shape_persian.py) 또는 너비 없는 조인자 분할(scripts/split_fa.js)을 사용하세요.
  2. 단어를 페이드하고 글자는 페이드하지 마세요. 연결된 글자는 겹칩니다. 글자별 불투명도나 투명한 텍스트 색상은 모든 연결 부분에 이음새를 남깁니다.
  3. 마스크에 여유가 필요합니다. 페르시아어는 라틴어보다 위아래로 훨씬 확장됩니다: 클립 마스크를 위아래로 약 0.5em 패딩하고, line-height ≥ 1.6(나스탈리크의 경우 ≥ 2.4)를 사용하세요. 그렇지 않으면 점과 گ의 상단이 잘립니다.
  4. 방향. 모든 페르시아어 블록에 dir="rtl" lang="fa"를 설정하세요. 라틴어 이름과 숫자는 <bdi>(또는 FSI/PDI)로 감싸세요. 그렇지 않으면 줄이 뒤섞입니다. 나타내기와 지연 시작은 오른쪽에서 시작하고, 카메라 진행은 왼쪽으로 이동하며, "다음" 화살표는 왼쪽을 가리킵니다. 재생 버튼, 시계 및 숫자는 절대 미러링되지 않습니다.
  5. 문자. 페르시아어 ی (U+06CC)와 ک (U+06A9), 아랍어 ي/ك 사용 금지; 페르시아어 숫자 ۰–۹ (U+06F0–06F9), 아랍어-인디아 숫자 ٠–٩ 사용 금지; 반각 공백(ZWNJ, U+200C)을 می‌, ‌ها, ‌تر/‌ترین에 사용; 문장 부호 ، ؛ ؟ « ». scripts/lint_persian.py가 이를 잡아냅니다.
  6. 글자 간격(letter-spacing) 사용 금지. Chrome은 버전 137 이후 페르시아어 단어 내에서 이를 무시하고 다른 도구는 연결을 끊습니다. 대신 카시다(kashida)로 늘이되, 앞으로 연결되는 문자 뒤에만, 단어당 최대 한 개만 사용하세요.
  7. 글꼴을 매번 로드하세요. 페르시아어 글꼴(또는 아랍어 문자 하위 집합)이 로드되지 않으면 Chrome은 자동으로 시스템 글꼴로 대체됩니다. Remotion에서는 FontFace + delayRender를 사용하세요 (assets/remotion/src/fonts.ts 참조).
  8. 텍스트 작성. 하나의 레지스터로 자연스러운 페르시아어를 작성하세요; 영어 관용구를 단어 그대로 옮기지 마세요. 렌더링 전에 원어민이 모든 줄을 검토해야 합니다 (references/persian-copy.md).

기법 라이브러리

각각의 라이브 코드는 assets/sketches/sketches.js(일반 JS, 시간의 순수 함수)에 있으며 브라우저 페이지와 Remotion 내에서 SketchPlayer를 통해 모두 실행됩니다. 세부 사항, 숫자 및 각각이 나온 X 게시물은 references/techniques/에 있습니다.

#기법사용 대상스케치 ID
01하나의 카메라, 컷 없음영화의 기본 구조: 하나의 스트립 위의 장면들, 모션 블러와 시차를 이용한 휩 팬oner
02하나의 모양이 이야기를 전달전환: 마침표가 채팅 버블로 자라나고, 다시 다음 마침표로 이어짐match
03실제 UI, 연출됨제품 비트: 3D 속 실제 인터페이스, 호 위의 커서, 초점 이동ui
04박자에 맞춰 컷기능 소개 및 키네틱 타입: 모든 박자에 하드 컷, 펀치 인, 반전 프레임beat
052프레임 홀드, 라인 보일 포함깔끔한 UI 위의 손으로 그린 레이어: 그림은 2프레임 유지, 선은 12회/초로 흔들림boil
06종이 오려낸 글자따뜻한 타이틀 카드: 각 연결된 글자 그룹은 하나의 단단한 종이 조각cutout
07점은 마지막에워드마크 및 나타내기: 먼저 글자 몸체, 그다음 점이 떨어짐nuqta
08카시다, 글자 간격 아님유지된 음표의 강조: 연결 획을 늘이며, 서체 점으로 측정kashida

참신함이 아니라 브리핑에 따라 선택하세요: 하나 또는 두 가지 시그니처 기법을 일관되게 사용하면 체계적으로 읽히지만, 여덟 가지를 모두 한 번에 사용하면 릴(reel)처럼 읽힙니다.

이 스킬의 도구

  • scripts/shape_persian.py — HarfBuzz로 페르시아어를 모양화하고 글자 몸체, 점 및 연결된 글자 그룹으로 분할된 SVG 외곽선을 내보냅니다 (pip install uharfbuzz fonttools). 이것은 대본을 깨뜨리지 않고 글자별, 점별 및 카시다 애니메이션을 가능하게 합니다.
  • scripts/split_fa.js — 페르시아어 단어를 연결된 형태를 유지하는 글자들로 분할합니다(너비 없는 조인자 사용). 외곽선이 과할 때 사용합니다.
  • scripts/lint_persian.py — 텍스트(아랍어 문자 및 숫자, 누락된 반각 공백, 영어 문장 부호, 잘못 배치된 카시다)와 코드(글자 간격, 글자별 상자, 누락된 dir)를 검사합니다.
  • assets/sketches/ — 모션 엔진(engine.js), 8개의 스케치, 모양화된 글리프 데이터, 스타일 및 gallery.html(정적 서버로 폴더 제공).
  • assets/remotion/ — SketchPlayer(프레임 번호로 스케치 구동), 기법당 하나의 클립 컴포지션, 작업 예제로서의 전체 인트로 영화, 클립 및 스틸을 렌더링하는 스크립트.
  • assets/music/compose_shur_pulse.py — Dastgah Shur의 120 BPM 오리지널 트랙을 코드로 작성했으며 비트 맵 포함; 편집을 음악에 고정하는 방법을 보여줍니다.

사용자가 빠른 작업만 원할 때

여전히 비용이 들지 않는 두 가지 불가결 사항을 지키십시오: 페르시아어에 대한 글자별 상자 사용 금지, 장면 간 페이드 사용 금지. 하나의 기법을 잘 사용하고, 비트 그리드에 타이밍을 설정하고, 전체 렌더링 전에 스틸 이미지를 렌더링하여 페르시아어를 확인하십시오.

관련 스킬