Communitygithub.com

edit-motion-graphics

HyperFrames/GSAP 기반 모션 그래픽 작품(제품/앱 론칭, 기능 소개, 키네틱 타이포그래피, 로고 리빌, UI 설명, 애니메이션 스크린샷)을 설계, 제작 및 검토하는 전문 기술입니다.

edit-motion-graphics란 무엇인가요?

이 스킬은 HyperFrames(HTML + GSAP 타임라인)를 사용하여 최종 MP4 모션 그래픽 작품을 완성하는 전문 기술입니다. 핵심 산출물은 '프레임 단위 PROMPT.md'로, 이 문서가 작품의 청사진 역할을 하며 코드는 이를 렌더링하기 위한 도구일 뿐입니다. 주요 워크플로는 간트 차트, 카메라 움직임, 이벤트 테이블을 포함한 6개 블록 사양 초안 작성 → 승인 → 소스 비트 수집 → 코드 빌드 → 사운드 믹싱 → 최종 단일 렌더링 순서로 진행됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사전 승인된 PROMPT.md 없이 코드를 작성하지 않고, 최종 렌더링의 모든 프레임을 QA하는 등 엄격한 게이트를 통해 품질을 보장합니다. 런칭, 키네틱, 로고, 설명, 차분함 등 다섯 가지 레지스터를 지원하며, 각 레지스터는 고유한 화면 전환 속도, 이벤트 간격, 카메라 스타일 및 사운드 디자인을 가지고 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/edit-motion-graphics

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

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

문서

edit-motion-graphics은(는) 무엇을 하나요?

완성된 모션 작품(MP4)의 결과물 소유자로, HyperFrames HTML + 일시 정지된 GSAP 타임라인으로 빌드됩니다. 프레임 수준의 PROMPT.md가 핵심 산출물이며, 코드는 이를 렌더링하기 위한 도구일 뿐입니다.

절대 규칙 (먼저 읽으십시오)

  1. 승인된 프레임 수준 PROMPT.md 전에는 코드를 작성하지 마십시오 - 자동 실행에서도 마찬가지입니다: 에이전트가 초안을 작성하고, 사람이 승인합니다(결정 기본값 Q6). 승인은 파일에 기록된 라인 APPROVAL: <who> <date>입니다. 변경 순서는 항상 원장(ledger) -> PROMPT.md -> 코드입니다.
  2. 여기서 비용을 지출하지 마십시오. AI-3D, AI 정지 이미지 또는 유료 생성은 paid-generation-gate를 통해 진행됩니다; 이 스킬은 유료 호출을 하지 않습니다. 카탈로그 목록은 계정 접근 권한이 아닙니다.
  3. 검토 순서: 스튜디오 프리뷰 -> hf_segment 범위 -> 수정 노트당 ONE 전체 렌더링 -> 최종 렌더링에 대한 모든 프레임 QA. 한 번에 하나의 무거운 작업(render_lock). 노트를 모아서 처리하십시오; 사용자가 아직 작성하는 동안 진단하되 렌더링하지는 마십시오.
  4. 하드 트랩: HyperFrames 루트에 dir="rtl" 금지(RTL은 텍스트 요소에만, <html>에 lang="he"); 파일 폰트(hf/fonts/의 @font-face); hyperframes snapshot --describe false, 호출당 최대 5개 타임스탬프; ASCII 작업 루트(new_project).
  5. 실패 시 중단: 실행할 수 없는 게이트는 blocked(not_run) 상태이며, 절대 pass가 아닙니다. 시간 초과, 빈 샘플 또는 누락된 렌더링은 절대 통과하지 않습니다. 성공적인 도구 호출은 실행 증거이고, 본 렌더링은 외관 증거입니다; 정지 이미지는 모션을 증명할 수 없습니다.
  6. 법칙 vs 취향: 규칙 1-5는 법칙입니다. 아래에 스튜디오 스타일로 표시된 항목(기본 자막 없음, 금지 목록, "핑크 금지", Higgsfield 문법, 21세기 우선)은 소유자의 취향이며, 그 이유와 함께 학습됩니다; 이를 무시하는 브리핑이 있으면 취향보다는 브리핑이 우선하지만, 게이트에서는 절대 우선하지 않습니다.
  7. 숫자는 자체 fps를 가집니다(브리핑에서 달리 명시하지 않는 한 30fps) 측정된 타이밍은 해당 머신의 정보를 포함합니다(소유자의 Windows 11 / Ryzen 7 7435HS / RX 7600S / 32 GB). NVIDIA/Apple 타이밍은 측정되지 않았습니다. 지출, 설치 또는 게시를 제한하는 프로젝트는 이 스킬을 재정의합니다.

입력 -> 출력

입력: 브리핑/원장(video-intake에서 가져옴), 브랜드 키트, UI 스크린샷 또는 컴포넌트, 음악/VO. 출력: hf/PROMPT.md(프레임 수준), hf/DESIGN.md(고정된 팔레트 + 타이포그래피 + 모션 토큰), hf/cues.js(영상과 사운드의 단일 타이밍 소스), hf/SOURCES.md, 컴포지션, mix.wav, 최종 MP4, QA 보고서. 핸드오프: 노트 -> revision-round; 기타 비율 -> multi-video-variants(전체 레이아웃 재구성, 자르기 금지); 전달 게이트 -> render-qa-deliver; 참조 제공됨 -> 먼저 reference-style-transfer(참조 없음 -> "스타일"에 해당하는 시간 범위를 질문).

절차

  1. 등록 + 인테이크. 레지스터(launch | kinetic | logo | explainer | calm) 중 하나를 선택하고 길이, 비율, VO, 음악, 전달 파일명을 고정합니다(references/launch-register-and-pace.md). 30초 고밀도 런칭은 1.7배 빠르게 느껴졌습니다; 승인된 길이는 45초였습니다: 먼저 길이를 결정하십시오.
  2. PROMPT.md + DESIGN.md 초안 작성(6개 블록; 카메라, 이음새 및 이벤트 테이블; 3D가 있는 경우 비트 카드). python scripts/motion_spec_check.py hf/PROMPT.md --register <r> 실행; 수정; 승인 요청.
  3. 소스 비트 수집(references/ui-sources-and-port.md): 카탈로그 -> hf-blocks -> shadcn 레지스트리(기본값) -> 계정이 있는 경우에만 21st.dev -> 수동 구축; 비트당 3D 결정(references/three-d-decision.md).
  4. 빌드 하나의 index.html + cues.js; 포팅된 컴포넌트는 시크-세이프(seek-safe)하게 재작성됩니다. 그런 다음 hf_preflight --strict, python scripts/seek_safe_scan.py hf/, python scripts/palette_audit.py hf/DESIGN.md hf/ [--png <3D renders>].
  5. 시각적 승인: 네 장의 스틸 + 모든 이음새의 스냅샷 + sheet 연락처 시트; 스튜디오 프리뷰; 노트 배치.
  6. 사운드(references/sound-and-captions.md): hf_mix --report; 모든 브랜드 이벤트에 브랜드 사운드; 멀티플렉싱 및 최종 파일 측정.
  7. 하나의 전체 렌더링 잠금 상태에서 먼저 ETA를 제시; frame_qa, motion_qa, hf_deliver; agent-content/benchmarks/motion-graphics.rubric.md를 사용하여 별도의 비평가로 채점; 파일, 번호가 매겨진 변경 사항, 체크된 원장 및 정직한 격차를 제시합니다.

레지스터 한눈에 보기(자세한 내용: references/launch-register-and-pace.md)

레지스터새 화면이벤트 간격카메라사운드
launch2-6초마다, 2개 이상의 깊이 레이어<= 0.5-1초; 수동 계수 45-110/분절대 멈추지 않음(드리프트 2-4%/s, 푸시인 8-15%)음악이 SFX; 모든 브랜드 이벤트에 브랜드 사운드; 링아웃
kinetic1-3초마다최대 ~200/분(단어 교체 포함)타입이 카메라키워드가 발화된 후 0..+7 프레임에 도달
logo하나의 아이디어, 3-8초결과가 0.4-0.75초 이내에 보임한 번 움직이고 안정화리빌 시 브랜드 사운드; 3단계 종료
explainer아이디어당, 3-6초30-110/분목적에 따라, 설명하는 대상으로VO 주도; 가시적 변화에만 SFX
calm홀드 허용드문 것은 괜찮음느리거나 고정하나의 균일한 배경음 + 미세한 폴리; 라이저/드롭 없음

비트당 3D (다섯 줄)

비트별로 결정하고 이유를 PROMPT.md에 작성하십시오: Blender 실제 지오메트리 / 히어로 재질이 2초 이상 화면에 표시되는 경우(EEVEE 우선; 384-640px에서 1.2-2.25초/프레임 측정, 런칭당 +1-1.5분 추가); Three.js 데이터 기반, 인스턴스화, 실시간 텍스트가 있는 3D-UI, 라운드별 편집 또는 정확한 16진수 비트, 1초 hf_segment AMD 게이트 이후; AI-3D paid-generation-gate 및 라이선스 확인 뒤에만; 2.5D (depth_25d, Depth Anything V2 Small, 2초 클립당 8.1-9.9초) 약간의 움직임이 필요한 정지 이미지용; 없음 UI/메시지 비트용. 3D 객체는 정보를 가리지 않으며 단어에 반응합니다.

"지루함 / AI처럼 보임 / 정적임" 타임스탬프 처리

비트 개념을 대체하고, 다듬지 마십시오. 메뉴에서 선택하십시오: 실제 VO 스펙트럼으로 구동되는 음성 오브; 데이터 기반 빌드(막대, 카운터, 경로 지구본); 코드로 재구축되고 객체(원근, 피사계 심도, 150-300% 확대)로 촬영된 UI; 콘텐츠를 전달하는 공유 요소 모프; 제자리에서의 숫자 또는 단어 교체; 키워드에 착지하는 3D 히어로. 작은 구석 "기능 알약", 작은 푸시인이 있는 평평한 스크린샷, 또는 검은색 배경의 점은 절대 안 됩니다. 금지 라인에 노트를 추가하고 모든 발생 지점에서 수정하십시오(반복될 때 전역 규칙).

시간 예산(소유자 머신에서 모델링 또는 측정; 학생 측정 아님)

목표: 30-45초 런칭의 첫 번째 제출 가능한 초안을 약 3-4시간, 1-2회 수정 라운드로 완성(첫 번째 실제 런칭은 10개 초안, 7개 비평 라운드, 4개 소유자 노트 라운드 소요); 라운드당 정확히 ONE 전체 렌더링. 렌더링 참조(HyperFrames 0.8.98, E11, 무거운 40초 / 1200프레임): 작업자 1명 132.6초, 4명 92.8초, 8명 88.1초; 브라우저 GPU -12%; 캡처가 병목(CPU 사용률 16개 논리 코어 중 2-3개만 사용). 이전 프리미엄 렌더링: 일반적으로 8-14분, 관찰 범위 4-21분(0.8.79-0.8.93). 항상 한 단위를 벤치마킹하고 3분을 초과하는 작업 전에 ETA 라인을 게시하십시오.

게이트

상태: pass | fail | blocked | n/a, 항상 이유와 함께.

게이트조건증거거짓인 경우소유자재확인
G0 인테이크레지스터, 길이, 비율, 전달 파일명, VO/음악 소스, 참조 답변 기록됨hf/BRIEF.md질문(라운드당 3-4개 질문); blockedvideo-intake브리핑 변경 시
G1 프레임 수준 사양6개 블록; 모든 비트에 프레임 + px + 이징 + 사운드 + 전환 포함; 금지 라인; 16진수 팔레트; APPROVAL: 라인motion_spec_check.py 종료 코드 0 (2 = 승인 누락 = blocked)사양 수정; 코드 전에 중단이 스킬 + 사람 승인자리타임 또는 새 비트
G2 깨끗하고 부드러움씬당 ONE 스플라인, 각 이동 >= 1.2초, 역방향 이동 >= 1초 및 <= 1.3배, 모든 키프레임에서 텍스트가 프레임 내부에 있음, 이음새 종료 = 시작, 히어로 유지, 반복 기술 없음, 페이드 없음PROMPT의 테이블 + 검사기; motion_qa 렌더링에서 0 지터 범위리타임/리패스; 다듬기보다 비트 개념 대체이 스킬카메라 또는 이음새 변경 시
G3 밀도레지스터 기준: 런칭 = 2-6초마다 새 화면, 이벤트 간격 <= 0.7초(선언된 숨 참기 제외), 45-110개 이벤트/분(수동 계수)이벤트 테이블 + 씬당 3개 프레임 샘플비트 추가 또는 교체; 채우는 대신 긴 동작을 1.6배로 늘임이 스킬리타임 후
G4 비트당 3D모든 3D 비트에 카드 포함: 경로(Blender / Three.js / AI-3D / 2.5D / 없음), 한 문장 이유, ETA, 게이트 증거, 라이선스비트 카드 테이블; Three.js 행: 1초 hf_segment 프레임이 비어 있지 않음재결정; AI-3D 행은 paid-generation-gate 필요이 스킬새 비트 또는 에셋
G5 팔레트 고정하나의 팔레트 테이블; 소스의 모든 16진수와 모든 3D 렌더링이 그 안에 있음palette_audit.py 종료 코드 0 (+ --png)재색칠/재렌더링; 테이블 없으면 blocked이 스킬새 에셋, 새 렌더링, 색상 노트
G6 UI 소싱각 UI/효과 비트에 SOURCES.md 행(출처, 라이선스, 버전, 날짜) 및 시크-세이프 포트 포함; 프로젝트에 npx shadcn add 없음; 21st 미리보기/미디어 복사 없음SOURCES.md + 스캔이유와 함께 소스 교체 또는 수동 구축이 스킬새 컴포넌트
G7 시크-세이프hf_preflight --strict 0 오류; seek_safe_scan.py 0 오류; 비순차적 시간대의 스냅샷 일치보고서 + 스냅샷 쌍수정; 이유 없이 억제하여 "수정"하지 마십시오이 스킬모든 코드 패치 후
G8 사운드모든 브랜드 이벤트에 브랜드 사운드; VO 아래 SFX -18..-26 dB 및 영상보다 1-3프레임 먼저; 음악 링아웃; 최종 파일 -14 LUFS +-0.5, TP <= -1(하우스 프리셋 v1, Q5)hf_mix --report, hf_deliver가 FINAL 파일에서 확인리믹스 및 리멀티플렉스(재렌더링 불필요)render-qa-deliver 측정오디오 또는 영상 리타임
G9 자막브리핑에서 요청하지 않는 한 자막 요소 없음ids/classes + <direction> 라인 grep제거 / 한 줄로 질문이 스킬브리핑 변경
G10 렌더링 + QA이번 라운드 ONE 전체 렌더링; frame_qa 0 플래그; 루브릭 평균 >= 4.0, 모든 차원 >= 3, M1/M3/M7 >= 3; 모든 원장 라인 체크됨QA 보고서 + 비평가 출력실패한 게이트로 돌아가기; 에스컬레이션 전 최대 한 번의 수정 라운드render-qa-deliver각 전체 렌더링

게이트 결과 기록(hf/QA.md, 게이트당 한 줄)

G1 pass   motion_spec_check exit 0, 24 beats, approval "<who> 2026-10-02"  (r2 리타임 후 재실행: pass)
G5 blocked  3D render coin_r2.png not readable by palette_audit (not_run) - Pillow 설치 또는 다운스케일
G7 fail   seek_safe_scan SS02 index.html:211 Math.random -> 시드 해시; 재검사 대기 중

라인이 없는 게이트는 not_run입니다. 이전 라운드의 기억으로 pass를 작성하지 마십시오: 리타임, 새 에셋 또는 패치는 이를 무효화합니다(재확인 열 참조).

초안 제시(render-qa-deliver가 전달 게이트 소유)

메시지 = 파일을 즉시 + 번호가 매겨진 변경 사항(사용자 자신의 노트 번호 기준) + 체크된 모든 라인의 원장 + 별도 비평가의 루브릭 점수 + 확인되지 않은 사항(Hebrew 교정, 기기 오버레이, 전화기의 음량) + 스튜디오 링크. 플래그가 지정된 프레임, 실패한 게이트 또는 체크되지 않은 원장 라인과 함께 절대 제시하지 마십시오.

참조(다음 경우 로드)

  • references/seam-camera-event-tables.md - PROMPT.md 작성 또는 검토 시 ALWAYS; 또한 agent-content/techniques/frame-spec-prompt.md 및 clean-smooth-motion.md.
  • references/launch-register-and-pace.md - 레지스터 선택, 속도 불만, 금지 목록, 이징 숫자.
  • references/three-d-decision.md - 깊이 또는 3D가 있는 모든 비트; 2.5D의 경우 agent-content/techniques/2-5d.md.
  • references/ui-sources-and-port.md - UI 카드, 효과, 스크린샷 애니메이션; agent-content/techniques/screenshot-rebuild.md.
  • references/seek-safe-and-render-traps.md - 코드 작성, 패치, 렌더링 차이점.
  • references/palette-lock.md, references/typography-hebrew-kinetic.md, references/sound-and-captions.md - DESIGN.md, Hebrew 타이포그래피, 사운드 계획.
  • references/dated-versions.md - 고정 및 라이선스(날짜가 있음; 만료됨 = 알 수 없음).
  • 스크립트(python <script> --self-check 먼저): motion_spec_check.py, palette_audit.py, seek_safe_scan.py. 텍스트와 패턴을 확인하고 외관은 확인하지 않습니다.

중단 및 에스컬레이션

차단되었을 경우, 추측하지 마십시오: 승인 라인 없음; 렌더링 불가능; 게이트 입력 누락; 가격 또는 라이선스 알 수 없음; Three.js 비트의 1초 세그먼트가 AMD에서 비어 있음(Blender 스프라이트로 대체). 지출, 설치, 게시 또는 제3자에게 메시지를 보내기 전에 질문하십시오. 다른 에이전트 세션에 메시지를 보내지 마십시오. 사용자 노트 "지루함 / AI처럼 보임 / 정적임"이 타임스탬프와 함께 있으면 레지스터 메뉴에서 비트 개념을 한 줄 설명으로 대체하십시오.

유지보수

변동 가능한 사실은 references/dated-versions.md 및 전역 날짜 모듈(hyperframes-traps.md, three-d-routes.md, audio-mix.md)에만 존재합니다. 모든 새 소유자 노트는 이 파일이 아닌 금지 라인에 추가하십시오. 지정되고 결정론적인 검사만 수행; 모델 평가는 실행하지 않음(결정 기본값 Q4).

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Deliver one approved video as several outputs (other aspect ratios, hook variants, platform versions, no-music/no-captions versions) or run several videos in parallel, with one shared mix, strict naming and a manifest that blocks stale derivatives. Triggers: export as 9:16 and 1:1, hook variants, variants batch; גרסאות, וריאציות הוק, כמה סרטונים יחד, 9:16 ו-16:9. NOT for a single deliverable (render-qa-deliver) or designing the master (the type skill).

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

관련 스킬