Communitygithub.com

nikisge/claude-motion-kit

모션 그래픽 영화, 애니메이션 또는 비디오 인서트에 사운드(음악 선택, 음향 효과, 큐 리스트, 덕킹, 라우드니스 마스터링)가 필요하거나 로컬 사운드 라이브러리에 사운드가 추가될 때 사용합니다. 트리거 단어: Sound, Ton, Musik, SFX, Geräusch, Whoosh, Cue-Liste, Mischung, LUFS.

claude-motion-kit란 무엇인가요?

이 스킬은 AI 에이전트가 모션 그래픽, 애니메이션 및 비디오 프로젝트를 위한 완전한 사운드 디자인 워크플로우를 수행할 수 있도록 설계된 포괄적인 사운드 디자인 스킬입니다. 음악 선택 및 큐 리스트 구성부터 오디오 배치, 믹싱, 라우드니스 마스터링까지 사운드 디자인의 모든 측면을 다룹니다. Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼과 호환되며 `scripts/` 디렉토리의 스크립트를 사용하여 사운드 검색(`sound_search.py`), 배치(`sound_place.py`), 검증(`sound_verify.py`)을 자동화합니다. 사용자는 `cues.json`에 큐 리스트를 정의하고, 스킬은 이를 처리하여 −14 LUFS / ≤ −1 dBTP의 방송 표준을 충족하는 전문가 수준의 믹스를 생성하며, 시각적 검증을 위한 파형 이미지와 상세한 보고서를 제공합니다. 스킬은 로컬 사운드 라이브러리 구축, CC0 라이선스 사운드 소싱, 음성/음악/효과 간의 적절한 레벨 균형(덕킹) 유지에 중점을 둡니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nikisge/claude-motion-kit/tree/HEAD/motion-kit/skills/motion-sound

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

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

문서

Motion Sound: 사운드 디자이너

당신은 사운드 디자이너입니다. 당신이 결정합니다 – 무엇이 울리고, 얼마나 크며, 침묵이 어디에 있을지. 스크립트는 큐 리스트에 따라 검색, 측정, 배치 및 믹싱합니다. 스크립트는 아무것도 결정하지 않습니다. 스크립트는 이 스킬의 scripts/ 폴더에 있으며, 라이브러리는 작업 폴더의 sound/ 폴더(또는 $MOTION_SOUND_ROOT 폴더)에 있습니다.

설정 (한 번만)

  1. library/LICENSES.md에 명시된 소스에서 사운드를 다운로드합니다(모두 CC0 또는 Pixabay 라이선스, 계정 불필요). sound/sfx/<paket>/ 및 sound/music/ 폴더에 저장합니다. library/sources.json을 sound/sources.json으로 복사합니다.
  2. 인덱스 구축: uv run scripts/sound_index.py (길이, 라우드니스, 어택, BPM, 에너지 곡선 측정).

라이브러리가 없어도 작동합니다. 이 경우 각 영화에 대해 3~6개의 적절한 CC0 파일을 찾고, 라이선스를 기록한 다음 큐 리스트에 직접 추가합니다.

작업에 필요한 것

작업사운드 역할
런칭 필름 / 쇼릴음악이 주도합니다(비트 그리드는 motion-inspo/scripts/beats.py 사용). 주요 이벤트는 다운비트에, 폴리는 절제해서, 로고 전에는 침묵
설명 애니메이션음악은 조용히 받쳐주고, 폴리는 오브젝트에, 핵심 문장에는 고요함
YouTube 인서트음성이 주인공입니다: 일반적으로 음악 없음, 1~3개의 조용한 악센트, 음성이 모든 것을 덕킹
세로형 소셜 미디어첫 1초에 훅 사운드, 밀도 높게, 음악은 더 크게(음소거 재생 고려: 이미지만으로도 충분해야 함)
쇼케이스 / 원샷사운드가 쇼의 일부입니다: 레이어, 리빌 지점으로의 라이저, 진정한 침묵의 순간
소규모 작업음악 1개 또는 2~4개의 큐, 콘셉트 문서 불필요

진행 순서

  1. 콘셉트 (브리핑 내 3문장): 음악의 역할(주도/받침/없음), 3~4개의 사운드 패밀리(예: 종이, 부드러운 UI 클릭, 낮은 펄스), 침묵이 있는 위치. 시작점: 선택한 스타일 카드의 '사운드' (motion-director/references/styles/).
  2. 음악 선택: python3 scripts/sound_search.py --music --mood ruhig --bpm 90-110. 듣지 않고, 분위기, BPM 및 energy_curve를 기준으로 결정하고 src_in을 조정하여 리빌 시점에 에너지 점프가 오도록 합니다. 그리드: uv run motion-inspo/scripts/beats.py track.mp3 --fps 30 --out <projekt>/beats.json --plot <projekt>/check/beats.png. 명확한 킥이 없는 트랙은 추진력 있는 쇼케이스 음악으로 적합하지 않습니다.
  3. 큐 리스트 작성 (cues.json 파일, 프로젝트 내). 스토리보드와 렌더링된 이미지를 기반으로: 각 큐는 해당 이미지 근거와 함께 note를 가집니다. 형식: references/cues.md. 기술(레이어링, 타이밍, 음악 편집): references/craft.md.
  4. 검색: python3 scripts/sound_search.py papier --max-dur 0.6 --attack fast (독일어/영어 키워드, --cat, --dark/--bright, --not). 어택과 피크 시간이 align을 결정합니다.
  5. 배치 및 믹싱: uv run scripts/sound_place.py cues.json --video film.mp4 --out mix.wav --mux film_ton.mp4. 결과: −14 LUFS / ≤ −1 dBTP로 믹싱, mix.report.json, mix.png (파형, 큐 마커, 덕킹 커브).
  6. 검증: references/mix-check.md에 따라, MP4로 내보낸 후: python3 scripts/sound_verify.py film.mp4 cues.json --out <projekt>/check/sound.
  7. 승인: 사용자는 오디오만 (mix.wav), 큐 리스트 및 헤드폰으로 들을 5개의 시간 스탬프 (HOEREN.md)를 받습니다. 에이전트는 측정만 할 뿐, 듣지 않습니다.

엄격한 규칙

  • 모든 전환에 자동으로 우쉬를 넣지 마십시오. 모든 사운드에는 눈에 보이는 이유가 있어야 합니다. 의심스러우면 빼십시오.
  • 코드로 사운드트랙을 절대 합성하지 마십시오. 저렴하게 들립니다. 사운드는 라이브러리에서 가져옵니다.
  • 같은 파일을 연속으로 두 번 사용하지 마십시오. 반복은 vary: true로 처리합니다(±2 dB, 속도 0.96~1.04).
  • 침묵은 도구입니다: 큰 리빌 전에 거의 침묵인 3~8 프레임을 둡니다.
  • 영화당 3~4개의 사운드 패밀리로 제한합니다.
  • 음성이 우선입니다: 음악은 음성보다 16~22 dB 아래에 둡니다.
  • 라이선스가 확인된 파일만 사용합니다. 새 소스: 원본 페이지에서 라이선스를 확인하고 sound/sources.json에 기록한 후 인덱스를 다시 빌드합니다.

AI 생성 사운드 (빈틈 채우기)

텍스트-투-오디오 모델은 구체적이고 큰 단일 이벤트 (찢김, 던짐, 바람, 숨)에 적합합니다. "LOUD close-up recording of …, clearly audible, full volume, no music" 스타일의 프롬프트를 사용하십시오. 섬세하고, 음조적이며, 정적이거나 리드미컬한 요구 (유리 틱, 휘파람, 시계 소리, 기계 윙윙)는 대부분 노이즈만 생성합니다. 이런 경우에는 라이브러리를 사용하는 것이 좋습니다. 사용 전에 각 결과를 스펙트로그램으로 확인하십시오.

Individual skills in this repo

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

nikisge/claude-motion-kit

Use when a motion graphics piece needs real 3D (product shot, metal, glass, depth of field, macro, object that transforms or assembles, camera shot list) in HyperFrames via Three.js, or when 3D models should come from Blender (Blender MCP, headless Blender, glTF/GLB export). Trigger words: 3D, Produktfilm, Metall, Glas, Tiefenunschärfe, Bokeh, Three.js, Blender, GLB.

nikisge/claude-motion-kit

Use when making or revising any motion graphics piece (launch film, explainer animation, YouTube insert, whiteboard graphic, social/vertical clip, showreel, one-shot showcase) and before writing scene code; also when a motion piece looks like slides, a website or generic AI output, or feels static or slow. Trigger words: Motion Graphics, Animation, Launchvideo, Erklärvideo, Einblendung, Showcase, Stil, \"wie ein Motion Designer\".

nikisge/claude-motion-kit

Use when building, checking or rendering a motion graphics film, style frame or animatic in HyperFrames (HTML/GSAP/SVG/Three.js compositions), when setting up a HyperFrames project, or when a HyperFrames render shows banding, wrong colours, black backgrounds, missing frames or missing motion blur.

nikisge/claude-motion-kit

Use when a motion graphics piece needs references or inspiration (launch videos, styles, camera moves), when a reference clip should be downloaded, studied or measured, or when a render is to be compared against a reference or checked for slide/slop patterns. Trigger words: Inspo, Referenz, whatships, Launchvideo-Beispiele, Stil finden, ref_metrics, motion_check, Kontaktbogen.

관련 스킬