name: showreel description: 한국어 모션그래픽 영상(이력서용 쇼릴·홍보 영상·프로필 영상·티저·브랜드 필름·행사 홍보·제품 소개·교육 영상·메이킹 필름)을 콘셉트부터 납품까지 만드는 스킬. 정해 둔 무드나 템플릿을 고르지 않는다. 요청마다 콘셉트 후보를 여러 개 세워 가장 강한 것을 고르고, 구간마다 아트 디렉션을 새로 정해 코드(DOM·캔버스·WebGL 셰이더·3D)로 화면을 만든 뒤, 렌더한 프레임을 직접 보며 약한 구간을 다시 만드는 일을 반복한다. 음악·효과음·ElevenLabs 나레이션·codex-image 이미지·믹스·자동 검수까지 끝낸다. 사용자에게는 사용자만 아는 사실(대상·꼭 넣을 정보·자료 위치)만 묻고, 무드·길이·구성·나레이션 여부 같은 창작 결정은 스스로 내린다. '쇼릴', '모션그래픽', '애니메이션 영상 만들어줘', '홍보 영상', '소개 영상', '인물 소개 영상', '1분 영상', 'N초 영상', '이력서용 쇼릴', '놀라운 모션 그래픽 디자이너', '전력을 다해요', '키네틱 타이포', '나레이션 넣은 영상', '티저 영상', '하네스가 어떻게 동작하는지 영상으로' 같은 요청이면 영상이라는 말이 없어도 이 스킬을 쓴다. 실사 촬영본 컷 편집, 파일 자르기·변환만 하는 작업, Sora·Veo 같은 생성형 비디오 모델 호출, 슬라이드·PDF만 만드는 작업은 범위가 아니다.

모션그래픽 쇼릴 제작

이 스킬이 맞추는 기준

이 스킬은 아래 요청에서 출발했다.

당신이 얼마나 놀라운 모션 그래픽 디자이너인지 보여주는 역동적인 한글버전 1분 모션그래픽 비디오를 만들어 보세요. 이력서용 쇼릴 처럼요. 전력을 다해요.

요청의 각 부분이 결과물에 요구하는 것은 다음과 같다.

다른 주제(제품 소개, 행사 홍보, 인물 프로필)에 이 문장이 붙어 오면 주제는 요청대로 따르고, 만드는 기준은 위 표를 따른다. 이 문장이 없는 요청에도 "놀라운·역동적인·한글버전·전력을 다해요" 기준은 그대로 적용한다. "구간마다 다른 프로젝트처럼 보인다"는 기준은 작업 모음 형식(쇼릴)일 때 적용한다. 브랜드·교육 영상처럼 한 작품으로 보여야 하는 영상은 한 영상 안의 일관성을 먼저 지키고, 매체와 움직임으로 장면을 나눈다.

정해 두지 않은 것

무드, 팔레트, 서체 조합, 장면 구성, 나레이션 여부는 요청마다 콘셉트 단계에서 정한다. 이 스킬의 이전 버전은 "어두운 배경 + 금색 강조 + 레터박스 + 필름 그레인 + HUD 모서리"를 기본값으로 두었고, 그 결과 주제가 달라도 영상이 비슷하게 나왔다. 이런 요소(references/design.md의 "뻔한 화면")는 콘셉트가 요구할 때만 의도해서 쓰고, 그 이유를 concept.md에 적는다.

스크립트·엔진·검수 도구는 그대로 쓴다. 도구는 화면의 모양을 정하지 않는다. 싱크, 결정성, 음량, 섬광 같은 기술 품질을 맞추는 데 쓴다.

기술 기본값

요청에 없는 항목은 아래 값으로 진행한다.

작업 위치

모든 작업 파일은 프로젝트 폴더 아래에 만든다. /tmp, /private/tmp, 세션 scratchpad에는 아무것도 저장하지 않는다. 세션이 끝나면 임시 폴더가 지워져 재생성 명령·검수 시트·생성 이미지·나레이션 테이크를 다시 쓸 수 없게 된다. 검수용 스틸과 시트는 <프로젝트>/qa/, 중간 렌더는 <프로젝트>/out/에 둔다.

프로젝트 폴더는 사용자가 지정하지 않으면 현재 작업 폴더 아래에 영문 소문자 이름(./<주제-slug>/)으로 만든다.

진행 방식

0 환경 점검 → 1 요청 읽기(필요한 것만 질문) → 2 콘셉트 → 3 조사·자료 → 4 구성·원고
→ 5 오디오 먼저(음악·효과음·나레이션 → 타임라인) → 6 이미지 → 7 스타일 프레임
→ 8 장면 제작 → 9 초안 렌더·비평 반복 → 10 최종 렌더·믹스·마감 → 11 자동 검수·납품 보고

질문은 1단계에서 사용자만 아는 사실에 한해서 한다. 그 뒤로는 묻지 않고 납품까지 진행한다. 진행 중 막히는 일(보이스 불가, 음악 API 불가, 확인되지 않는 사실)은 아래 대체 경로로 처리하고 납품 보고에 적는다.

오래 걸리는 작업(조사, TTS, 음악 생성, 이미지 생성, 최종 렌더)은 Bash run_in_background나 서브에이전트로 돌리고 그동안 다음 단계를 진행한다. sleep으로 기다리지 않는다. 구간이 여러 개인 영상은 구간마다 서브에이전트에 나눠 맡겨 동시에 만들 수 있다(references/engine.md의 "나눠 만들기").

스크립트 경로는 이 스킬 폴더 기준이다(~/.claude/skills/showreel/scripts/). 아래에서 S=~/.claude/skills/showreel/scripts로 줄여 쓴다.

0. 환경 점검

python3 $S/preflight.py

결과의 "쓸 수 있는 경로"를 콘셉트에 반영한다.

• codex CLI나 이미지 스킬이 없을 때: codex-image·photoreal·codex-cli 스킬은 https://github.com/revfactory/skills 에 있다. 출력된 설치 명령을 사용자에게 안내한다. 설치하지 않으면 코드로 그린 그래픽과 사용자 제공 사진으로 구성한다. 사용자가 "realphoto"라고 부르는 스킬의 실제 이름은 photoreal이다.
• ElevenLabs 키가 없을 때: 나레이션이 필요한 요청이면 preflight.py가 출력하는 키 발급 절차를 안내하고, 키를 받기 전까지 음악·화면 버전으로 진행할 수 있다고 알린다. 음악은 합성 경로로 만든다.
• 고른 보이스가 막힐 때(Free 플랜은 라이브러리 보이스를 쓸 수 없다): python3 $S/eleven.py voices --lang ko로 쓸 수 있는 보이스를 고르거나 플랜 업그레이드를 안내한다.

1. 요청 읽기

references/brief.md의 "물을 것과 묻지 않을 것"을 따른다.

• 묻는 것: 요청에 없고 조사로도 알 수 없는 사실. 대상이 누구·무엇인지, 실존 대상의 꼭 넣을 정보(이름 표기, 일시, 장소, URL, CTA), 사용자 자료의 위치.
• 묻지 않는 것: 무드, 팔레트, 길이, 화면비, 구성, 나레이션 여부, 이미지 사용 여부. Claude가 정하고 납품 보고에 적는다.
• 위 핵심 요청처럼 Claude 자신이 대상이면 아무것도 묻지 않고 바로 시작한다.

2. 콘셉트

references/brief.md의 "콘셉트 만들기"를 읽는다. 콘셉트가 약하면 뒤 단계에서 아무리 다듬어도 템플릿 영상과 구분되지 않으므로, 이 단계에 시간을 쓴다.

• 서로 다른 방향의 후보를 3개 이상 쓴다. 후보마다 한 문장 아이디어, 첫 5초의 화면, 구간 구성, 한글을 쓰는 방식, 이 영상에서 새로 풀어야 할 기술 과제를 적는다.
• 후보를 같은 기준으로 비교해 고른다: 첫 5초만 보고도 기억에 남는가, 앞 구간을 본 사람이 다음 구간을 예상하지 못하는가, 표현 범위가 넓은가, 이 주제가 아니면 성립하지 않는가, 템플릿 영상과 구분되는가, 한글의 형태를 재료로 쓰는가, 엔진과 남은 시간으로 만들 수 있는가.
• 고른 콘셉트를 <프로젝트>/concept.md에 쓴다. 구간마다 아트 디렉션(매체·팔레트·서체·움직임의 성격·질감)을 따로 정한다. 정하는 방법은 references/design.md의 "아트 디렉션 정하기"에 있다.
• 쇼릴(작업 모음·자기 소개)의 구성 방법은 references/story.md의 "쇼릴"에 있다.
• 콘셉트를 정하면 사용자에게 한두 줄로 알리고 확인을 기다리지 않고 진행한다.

3. 조사와 자료

먼저 프로젝트를 만든다. 폴더 구조, 엔진, 한글 폰트, 렌더러 의존성이 한 번에 준비된다.

python3 $S/new_project.py <프로젝트> --ratio 16:9 --duration 60 [--fonts "Hahmlet:wght@300;900"]

기본 서체 세트 밖의 Google Fonts 한글 서체는 --fonts로 더한다(여러 번 쓸 수 있고, 다시 실행해도 유지된다).

reel/scenes.js는 빈 장면 파일로 생긴다. API 사용 예시는 reel/_example_scenes.js에 있다. 예시의 화면을 출발점으로 삼지 말고 콘셉트에서 새로 쓴다.

인물·기업·행사·제품이 주제면 조사를 서브에이전트에 백그라운드로 맡긴다. 프롬프트는 references/brief.md의 "조사 요청 프롬프트"에 있다.

• 결과는 research/research.md에 남긴다. 사실마다 출처 URL과 확실도(확인/단일 출처/미확인)를 적는다.
• 영상에 넣는 숫자와 사실은 출처가 있는 것만 쓴다. 사용자가 준 정보가 조사 결과와 다르면 조사 결과를 따르고, 납품 보고의 "요청과 다르게 반영한 것"에 적는다.
• 실제 사진은 사용자 제공 자료, 공식 사이트, 보도 사진에서 고르고 출처를 research/photos.md에 적는다. 보도 사진은 납품 보고에 "공개 전 사용 허락 확인 필요"로 표시한다.
• 브랜드 색은 공식 사이트 CSS나 로고에서 뽑는다. 로고는 그 회사의 영상일 때만 공식 파일을 쓰고, 다른 회사 로고는 그리지 않는다.

4. 구성과 원고

references/story.md를 읽는다. 쇼릴 구성, 용도별 참고 구성, 길이별 기준값, 카피 규칙, 발음 표기 규칙이 있다.

• storyboard.md: 구간·장면 표(시간·화면 카피·나레이션·화면 설계·전환·효과음·출처)
• script.json: 나레이션 줄, 장면 경계, 효과음, 음악. 형식은 narrate.py 맨 위 설명과 story.md의 "script.json 쓰는 법"을 따른다.
  • 구간·장면 경계는 scenes에 적는다. 시작·끝에 마디 큐(bar9)와 히트 큐(music.hit2)를 쓸 수 있다.
  • 나레이션이 없으면 "lines": []로 두고 scenes·sfx·music만 채운다. narrate.py는 건너뛰고 timeline.py부터 실행한다.
  • 나레이션이 있으면 화면 표기(text)와 발음 표기(tts)를 나눠 쓰고, 장면 전환과 맞출 단어에 cues로 이름을 붙인다. 분량은 60초에 발음 표기 기준 255자(공백 제외)를 넘기지 않는다. 넘치면 화면이 나레이션을 따라가지 못한다.
• 날짜가 나오면 요일을 달력으로 대조한다(python3 -c "import datetime;print(datetime.date(2026,11,20).strftime('%A'))"). 맞지 않으면 요일을 빼고 보고에 적는다.

5. 오디오를 먼저 만든다

화면의 시각은 음악 박·히트와 나레이션 단어에서 정해지므로 오디오를 먼저 확정한다. 쇼릴은 음악이 편집의 기준이다. 음악 스펙의 섹션을 concept.md의 구간과 맞추고, 곡의 장르·악기·질감은 global_styles로 콘셉트에 맞게 적는다. 자세한 기준은 references/audio.md에 있다.

python3 $S/narrate.py <프로젝트>/script.json --stt            # 나레이션이 있을 때. ✗ 줄은 고쳐서 다시
python3 $S/music_tools.py plan <프로젝트>/audio/music/spec.json # 음악 스펙 → ElevenLabs 구성 플랜
python3 $S/eleven.py music <프로젝트>/audio/music/music.mp3 --plan <프로젝트>/audio/music/plan.json
#   402(유료 플랜 필요)면: python3 $S/synth_music.py music <프로젝트>/audio/music/spec.json <프로젝트>/audio/music/music.wav
python3 $S/music_tools.py analyze <프로젝트>/audio/music/music.mp3   # 템포·히트 → 구간 경계를 히트에 맞춘다
python3 $S/eleven.py sfx-kit <프로젝트>/audio/sfx --names impact,riser   # 범용 프리셋이 필요한 곳만(합성: synth_music.py sfx). 구간 재질에 맞는 소리는 eleven.py sfx "prompt"
python3 $S/timeline.py <프로젝트>/script.json --music-analysis audio/music/analysis.json

• 음악 섹션은 4마디 단위로 잡는다(120 BPM이면 8초). ElevenLabs Music은 그 단위로 곡을 만들기 때문에, 드롭이 원하는 시각보다 늦게 나오면 music_tools.py splice로 빌드업 끝 몇 박 뒤에 드롭 구간을 이어 붙여 당긴다.
• 효과음은 화면의 움직임마다 맞춰 설계한다. 프리셋 이름만 고르지 말고 eleven.py sfx "prompt"로 구간의 재질(종이, 유리, 액체, 전자음)에 맞는 소리를 만든다.

timeline.py가 timeline.json(믹서·검수용)과 reel/timeline.js(화면용 큐·단어 시각·소리 크기 곡선)를 만든다. 겹침·길이 초과·큐 누락이 있으면 ✗로 알려 주므로 모두 고친 뒤 장면을 만든다. 나레이션 문구나 시각을 바꿀 때는 script.json만 고치고 narrate.py(바뀐 줄만 다시 생성)와 timeline.py를 다시 실행한다.

6. 이미지

콘셉트에 사진이나 생성 이미지가 필요할 때만 한다. references/images.md를 읽는다.

• 생성: ~/.claude/skills/codex-image/scripts/codex_imagegen_batch.sh <프로젝트>/assets/gen "프롬프트::이름.png" … (5장씩 병렬, 장당 약 1분)
• 사람이 나오는 사진풍 이미지: photoreal 스킬로 프롬프트를 만든다.
• 실제 대상을 닮게 만들 때: $S/codex_ref_image.sh로 참조 사진을 붙인다.
• 후처리: python3 $S/prep_images.py <프로젝트>/assets/gen --out <프로젝트>/assets/img [--cutout]. 레터박스 제거, 확대, 누끼를 한다.
• 확인: python3 $S/prep_images.py --sheet <프로젝트>/assets/img --out <프로젝트>/qa/sheet_images.png로 시트를 만들어 Read로 본다. 손가락·글자·로고가 섞인 이미지는 다시 만든다.

7. 스타일 프레임

전체 장면을 쓰기 전에 구간마다 대표 프레임을 1~2장 만들어 한 시트로 본다.

• 각 프레임을 포스터로 써도 될 수준인가, 구간끼리 서로 다른 작업으로 보이는가, design.md의 "뻔한 화면"에 해당하는 요소가 이유 없이 들어가 있지 않은가를 본다.
• 기준에 못 미치는 구간은 이 단계에서 방향을 바꾼다. 방향이 둘 이상 떠오르는 구간은 둘 다 만들어 비교한다. 장면을 다 만든 뒤에 방향을 바꾸는 것보다 비용이 적다.

8. 장면 제작

references/engine.md(엔진 API, 장면 작성법, WebGL·3D, 나눠 만들기)와 references/design.md(아트 디렉션, 움직임 원칙, 리듬, 한글 타이포)를 읽고 장면을 쓴다. references/techniques.md는 검증된 기법 코드 22종이다. 콘셉트가 요구하는 표현이 거기 있으면 코드를 가져다 쓰고, 없으면 새로 만든다. 목록에서 고르는 것으로 장면을 기획하지 않는다.

• 엔진 규칙: 화면은 시간 t의 순수 함수다. Math.random, Date.now, CSS transition·animation, 이전 프레임 상태에 기대는 코드를 쓰지 않는다. 렌더러가 임의 시각으로 이동하고 여러 워커가 나눠 그리기 때문이다. 물리 시뮬레이션처럼 누적이 필요한 계산은 setup에서 고정 간격으로 미리 계산해 두고 render에서 시각으로 읽는다.
• 표현 수단에 제한을 두지 않는다. DOM·SVG, 캔버스 2D, WebGL2 셰이더, three.js 3D가 모두 렌더된다(engine.md의 "WebGL: 셰이더와 3D").
• 시각은 숫자를 직접 쓰지 말고 REEL.cue('이름')로 타임라인 큐를 쓴다. 그래야 오디오를 다시 만들어도 화면이 따라온다.
• 하드 컷·상태 전환은 큐보다 0.5프레임 앞에 둔다(cue(x) - 0.5/fps). 모션 블러 셔터가 프레임 앞뒤에 걸쳐 있어서, 그래야 큐 프레임에 새 상태가 정확히 보인다. 장면 경계도 같다: REEL.scene({ start: cue('scene.s02') - 0.5 / REEL.fps, end: cue('scene.s02.end') - 0.5 / REEL.fps, … }). 정수 초 큐를 그대로 쓰면 --sub 4 렌더에서 경계 프레임에 앞뒤 구간이 섞인다.
• 첫 프레임을 어떻게 시작할지는 콘셉트가 정한다. 빈 화면·정적·페이드로 시작한다면 의도를 concept.md에 적는다. 의도하지 않은 빈 프레임으로 시작하지 않는다.
• 색은 concept.md의 구간별 아트 디렉션을 따른다. 실존 브랜드가 주제면 공식 색(사이트 CSS·로고)을 쓴다. reel/index.html의 색 토큰은 회색 자리 표시 값이므로 그대로 두지 않는다.
• 3분 넘는 영상이나 구간이 많은 쇼릴은 구간마다 scenes_sNN.js로 나누고 서브에이전트에 나눠 맡길 수 있다(engine.md의 "나눠 만들기").

9. 초안 렌더와 비평 반복

node $S/render.mjs --dir <프로젝트>/reel --stills <시작+0.5>,<큐+0.4>,<끝-0.6> --outdir <프로젝트>/qa/stills_<장면>   # 장면 하나를 만들 때마다
node $S/render.mjs --dir <프로젝트>/reel --every 0.5 --outdir <프로젝트>/qa/stills     # 전체 스틸(모든 장면이 생긴 뒤)
python3 $S/contact_sheet.py --dir <프로젝트>/qa/stills --out <프로젝트>/qa/sheet_stills.png --timeline <프로젝트>/timeline.json
node $S/render.mjs --dir <프로젝트>/reel --out <프로젝트>/out/draft.mp4 --scale 0.5          # 초안(60초에 약 30초)
python3 $S/contact_sheet.py --video <프로젝트>/out/draft.mp4 --every 1 --out <프로젝트>/qa/sheet_draft.png
python3 $S/motion_check.py <프로젝트>/out/draft.mp4 --timeline <프로젝트>/timeline.json   # 실수로 멈춘 구간·큰 움직임 부족·섬광 과다를 시각과 장면 이름으로 알려 준다
python3 $S/contact_sheet.py --video <프로젝트>/out/draft.mp4 --around <구간 경계 초들> --frames 3 --out <프로젝트>/qa/sheet_cuts.png

만든 시트는 반드시 Read로 열어 직접 본다. 렌더한 프레임을 보지 않고 완료라고 하지 않는다.

초안마다 references/qa.md의 "비평"을 따라 구간별로 유지·고침·다시 만듦을 판정하고 qa/critique_NN.md에 남긴다. 가장 약한 구간은 수치를 조정하기보다 방향을 바꿔 다시 만든다. 한 번 고치고 끝내지 않는다. 모든 구간이 "유지"가 되고 qa.md의 기술 점검표를 통과할 때까지 반복한다. 최종 렌더 전에 한 번은 만든 맥락이 없는 서브에이전트에게 시트·프레임 띠·비평 질문만 주고 판정을 받아 qa/critique_NN.md에 남긴다. 만든 쪽이 놓친 문제를 찾기 위해서다.

motion_check.py가 △를 내면 그 시각이 의도한 정지인지 확인하고, 아니면 사건을 더한다. 섬광 ✗는 의도와 관계없이 초안 단계에서 고친다(광과민성). 최종 렌더 뒤에 고치면 렌더를 다시 해야 한다. 초안(모션 블러 없음)에서 통과해도 최종 렌더(--sub 4)에서는 컷이 두 프레임에 섞여 섬광이 늘 수 있다. 밝은 바탕에서 컷이 잦은 구간은 최종 렌더 전에 그 구간만 render.mjs --from <초> --to <초> --sub 4 --scale 0.5 --out <프로젝트>/out/chk_<구간>.mp4로 뽑아 motion_check.py로 확인한다. 렌더러가 종료 코드 2로 끝나면 페이지 오류가 난 것이니 로그의 오류부터 고친다.

10. 최종 렌더·믹스·마감

node $S/render.mjs --dir <프로젝트>/reel --out <프로젝트>/out/video.mp4 --sub 4 --format png   # 모션 블러. 60초에 약 3~5분, 백그라운드로
python3 $S/mix.py <프로젝트>/timeline.json
python3 $S/finish.py --video <프로젝트>/out/video.mp4 --audio <프로젝트>/audio/mix.wav \
  --name "<제목>_<길이>s" --outdir <프로젝트>/out --timeline <프로젝트>/timeline.json

나레이션에 리버브를 넣지 않는다. 2.4초 홀을 --hall 0.12로 걸었던 영상에서 "나레이션에 에코가 너무 많다"는 지적을 받았다. 공간감이 꼭 필요할 때만 --hall 0.04~0.08을 쓰고, mix.py가 출력하는 "말 끝 잔향"이 ✓(-32dB 이하)인지 확인한다.

mix.py가 줄마다 "나레이션 대 배경" dB를 보여 준다. ✗(6dB 미만)인 줄은 근처 효과음을 줄이거나 핵심 단어에서 0.2~0.3초 비켜 놓고 다시 믹스한다. 오디오만 고칠 때는 영상을 다시 렌더하지 않고 mix.py와 finish.py만 다시 돌린다.

11. 자동 검수와 납품 보고

python3 $S/qa_check.py <프로젝트>/out/<이름>.mp4 --timeline <프로젝트>/timeline.json --script <프로젝트>/script.json --stt

규격, 음량, 너무 어두운 구간, 섬광, 멈춘 화면, 완성 믹스의 받아쓰기(숫자 오인식 포함)를 검사하고 qa/qa_report.md와 최종 시트를 만든다. "고칠 것"을 모두 처리하고 최종 시트를 Read로 본 뒤 납품한다. STT에서 한 번만 틀린 줄은 한 번 더 돌려 두 번 다 틀릴 때 고친다.

납품 보고와 제작노트.md 형식은 references/qa.md의 "납품"에 있다. 다음을 반드시 넣는다.

• 산출물의 절대 경로 표
• 구간 구성표와 고른 콘셉트, 버린 후보
• Claude가 정한 것(무드·길이·나레이션 여부 등)과 요청과 다르게 반영한 것
• 공개 전 확인할 것: 사진 사용 허락, 단일 출처 사실, 시점이 지나면 틀리는 정보, AI 생성 인물이 가상이라는 점
• 재생성 명령
• 사운드를 직접 들어 봐 달라는 요청. Claude는 소리를 들을 수 없고 수치로만 확인했다.

지킬 것

• 실존 인물의 얼굴·몸은 이미지로 생성하지 않는다. 생성 이미지는 얼굴이 보이지 않는 환경·사물·뒷모습 컷으로 쓴다.
• 실존 회사의 로고·브랜드를 흉내 내지 않는다. 가상 의뢰 구간의 브랜드는 이름과 표장을 새로 만든다.
• 영상의 숫자·직함·연도는 조사 출처가 있는 것만 쓴다. 연출용 가상 수치를 쓰면 화면이나 보고에 그렇다고 밝힌다.
• 음악 프롬프트에 아티스트·작곡가·곡 이름을 넣지 않는다. 저작권 필터에 걸려 400으로 거부된다.
• ElevenLabs 크레딧을 아낀다. 바뀐 줄만 다시 만들고, takes는 고유명사·숫자 줄에만 쓴다.
• 섬광은 어두운 배경에서 opacity 0.15 이하로 쓰고, 1초에 3번을 넘기지 않는다(광과민성).

자주 생기는 문제

참조

showreel

A Claude Code skill that produces Korean motion-graphics videos from a single request — concept, research, script, narration, music, images, render, critique and rework, mix and QA.

English · 한국어

Highlights from a 2-minute promo for showreel, made with this skill. The full video below has sound.

Demo

The full 2-minute video was produced by this skill from one prompt: four ElevenLabs voices, generated music, sound effects, AI images, 22 motion techniques and an automated QA pass.

▶ Download the full demo (1080p, 2:00, 31 MB)

한국어 소개

showreel은 Claude Code에서 한국어 모션그래픽 영상을 만드는 스킬입니다. 정해 둔 무드나 템플릿을 고르지 않고, 요청마다 콘셉트 후보를 여러 개 세워 가장 강한 것을 고른 뒤 구간마다 아트 디렉션을 새로 정해 만듭니다. 사용자에게는 사용자만 아는 사실(대상, 꼭 넣을 정보, 자료 위치)만 묻고, 무드·길이·나레이션 여부 같은 창작 결정은 Claude가 내립니다. 조사, 원고, ElevenLabs 나레이션, 음악과 효과음, 이미지 생성, HTML·WebGL 모션 엔진 렌더, 비평과 재작업, 믹스, 자동 검수를 모두 거칩니다.

화면 전환은 나레이션 단어와 음악 박자에 프레임 단위로 맞춥니다. 완성본은 받아쓰기(STT)로 발음을 다시 확인하고, 음량·섬광·멈춘 화면을 검사한 뒤 납품합니다. 인물 프로필, 기업 홍보, 행사, 교육, 티저, 음악 기반 영상 등 실제 제작 13건에서 쓴 방법을 스크립트와 문서로 정리했습니다.

자세한 설명은 한국어 README에 있습니다.

Table of contents

• Demo
• Overview
• Features
• How it works
• Requirements
• Installation
• Quick start
• Defaults
• Script reference
• Repository layout
• Configuration
• Troubleshooting
• Limitations
• Contributing
• Security
• License
• Acknowledgments

Overview

showreel is an Agent Skill for Claude Code. It turns a short request such as "Make a 60-second promo for our product launch, cinematic, with narration" into a finished, delivery-ready video:

• a master MP4 and a lighter MP4 for sharing,
• a poster JPG and an SRT subtitle file,
• a production note listing sources, settings, open checks and the commands to regenerate every asset.

The skill is built around one request: "Show how amazing a motion graphics designer you are — a dynamic one-minute Korean motion graphics video, like a showreel for a résumé. Give it everything." The video itself has to prove the craft. There is no default mood or template: Claude writes several concept candidates, scores them, gives each segment its own art direction (medium, palette, type, motion character), builds the picture in code (DOM, Canvas 2D, WebGL shaders, three.js), and rebuilds the weakest segment after every draft until a written critique keeps every segment.

The skill is written for Korean content (Korean typography, Korean narration and pronunciation rules), but the engine, renderer and audio tools are language-neutral.

Features

How it works

flowchart LR
    A[0 Preflight] --> B[1 Read request<br/>ask only facts]
    B --> K[2 Concept<br/>3+ candidates scored]
    K --> C[3 Research & assets]
    C --> D[4 Storyboard & script]
    D --> E[5 Audio first<br/>music · SFX · narration → timeline]
    E --> F[6 Images]
    F --> G[7 Style frames<br/>per segment]
    G --> L[8 Scenes]
    L --> H[9 Draft & critique loop<br/>rebuild weakest segment]
    H --> I[10 Final render · mix · finish]
    I --> J[11 Automated QA & delivery report]

Audio is produced before the picture. timeline.py converts narration word timings and music hits into named cues, and scenes read those cues with REEL.cue('name') instead of hard-coded seconds. When a narration line is regenerated, the picture follows without edits.

Long-running steps (research, TTS, music, image generation, final render) run in the background while Claude continues with the next step.

Requirements

Korean fonts (Pretendard and Google Fonts families, all SIL OFL) are copied from your system or downloaded per project by new_project.py. No fonts are bundled in this repository.

Installation

1. Clone into your Claude Code skills folder

# Personal skill (available in every project)
git clone https://github.com/revfactory/showreel.git ~/.claude/skills/showreel

# Or project skill (shared with your team through the repository)
git clone https://github.com/revfactory/showreel.git .claude/skills/showreel

2. Install dependencies

brew install ffmpeg node
python3 -m pip install numpy pillow
cd ~/.claude/skills/showreel/scripts && npm install

3. Set your ElevenLabs API key (needed for narration)

echo 'export ELEVENLABS_API_KEY="sk_..."' >> ~/.zshrc && source ~/.zshrc

You can also put ELEVENLABS_API_KEY=sk_... in a .env file in the project folder.

4. Check the environment

python3 ~/.claude/skills/showreel/scripts/preflight.py

The preflight report lists each tool as ✓ or ✗, prints the install command for anything missing, and shows which production