showreel skill
A Claude Code skill that makes a Korean motion-graphics video from one request, from script to ElevenLabs voice, music and QA
- 73 ★ on the repository
- Last commit
Extended access
Why this level
- The skill runs a Chrome render and ffmpeg scripts and writes project files to the working folder
- The ElevenLabs key spends credits and narration text goes to a third-party service
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/showreelDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skill runs a Chrome render and ffmpeg scripts and writes project files to the working folder
- The ElevenLabs key spends credits and narration text goes to a third-party service
This is third-party code. Review the repository files before installing.
What it does
The skill turns a short request like "Make a 60-second promo for our product launch, cinematic, with narration" into a finished video: a master MP4, a lighter MP4 for sharing, a poster JPG, SRT subtitles and a production note with sources, settings and commands to regenerate every asset. It has no default mood or template: Claude writes at least three concept candidates, scores them on shared criteria and writes the winner to `concept.md` with separate art direction for each segment. The user is asked only about what they alone know: subject, must-have facts and asset locations. Claude makes the creative choices. A background research agent collects facts and each carries a source URL and a confidence level. The script splits on-screen text from pronunciation text and sizes it to the length: 60 seconds is about 240–255 Korean characters. ElevenLabs narration runs in per-line takes, only a changed line is regenerated and every line is verified by speech recognition. Music and effects also come from ElevenLabs, and the picture is built in code with DOM, Canvas 2D, WebGL and three.js. After each draft Claude rebuilds the weakest segment until a written critique keeps every one. Transitions are timed to narrator words and music beats frame by frame, and the finished video is checked for loudness, flashes and frozen frames. Claude cannot listen to audio, so those checks are numeric.
Who it is for. Designers, marketers and teams who need a Korean motion-graphics video, whether a promo, profile, event, teaser or training clip, built with Claude Code.
Good fit when
- You need a 60-second product teaser in Korean, tech-keynote style, with music and typography and no narrator
- A designer needs a résumé showreel with dynamic delivery
- An event needs a video with narration, SRT subtitles and a shareable version
- You want to rebuild only corrected narrator lines without re-recording the whole video
Not a fit when
- You need a video in another language: the skill is written for Korean typography and pronunciation rules
- You need faces and bodies of real people: the skill never generates them and real photos need permission
- You have no ElevenLabs key: API narration and music are unavailable
Example request
/showreel Our team built an internal search. We need a 60-second video, grand in tone, with narration.Limitations
The skill is written for Korean text: Korean typography, narration and pronunciation rules, while the engine, renderer and audio tools are language-neutral. It was tested on macOS, on Linux rendering and audio work with the `REEL_CHROME_PATH` variable, and person cutouts depend on macOS Vision. It needs Python 3.10 or newer with `numpy` and `Pillow`, Node.js 20 or newer, Chrome or Chromium and ffmpeg.
Narration needs the `ELEVENLABS_API_KEY` key: music requires a paid plan and library voices are not available on the free one. ElevenLabs usage spends credits and your plan sets the commercial terms. Image generation comes from Codex CLI and the codex-image skill, and without them the video uses typography and your own photos. You must listen to the result yourself before publishing.
How to disable. Delete the `~/.claude/skills/showreel` or the project `.claude/skills/showreel` folder. Remove the `ELEVENLABS_API_KEY` key from `~/.zshrc` or from `.env`, and finished video projects live in your own folders and are deleted by hand.
FAQ
How do I install showreel in Claude Code?
Run `git clone https://github.com/revfactory/showreel.git ~/.claude/skills/showreel`, then install dependencies: `brew install ffmpeg node`, `python3 -m pip install numpy pillow` and `npm install` in the `scripts` folder. Run the `preflight.py` script to check the environment.
How do I start the skill?
Open Claude Code in an empty folder and describe the video or type `/showreel`. The skill also triggers on showreel, motion graphics, promo video, teaser and "60-second video".
Do I need an ElevenLabs key?
Only for narration, sound effects and music. Music requires a paid plan and the Marcus voice is not available on the free one. Without a key the video is built on typography, graphics and your own photos.
Can I make videos in languages other than Korean?
The engine and tools are language-neutral, but the script and pronunciation rules are written for Korean. Other languages need new script and pronunciation rules.
What do I get?
A master MP4, a lighter MP4 for sharing, a poster JPG, SRT subtitles and a production note with sources and build commands. Together with them come `concept.md`, `storyboard.md`, `script.json` and the `qa_report.md` check report.
Discussion
No questions or reviews yet.
Related
SkillsA Claude Code skill that builds a Remotion film of your product from its own components, tokens and logo, cut to music
A Claude Code skill that builds motion graphics in code: 21 ready looks, five questions, three approval stills and an MP4 render.
A Claude Code skill for narrated explainers with a cartoon presenter, lip sync to your voice, poses on cue words and your brand
The video-explainer skill turns a script into a vertical 9:16 explainer: narration, captions, Remotion and a pre-render review
A skill that walks an agent through ten gates, from customer pain to final render, so a launch film looks directed.
A skill for Claude Code and Codex that builds app launch films from HTML, music and voiceover and renders them on your machine.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| showreel (this card) | no | 73 | |
| HyperFrames Motion Reel | no | 185 | builds a showreel on HyperFrames, while this one carries the whole path from concept and research to narration, music and QA |
| Motion Graphics Skill Pack | no | 660 | a set of motion-graphics techniques, while this one makes a finished Korean video with critique and rebuild of weak segments |
README in short
The description presents the skill as a chain from a request to a finished MP4 and gives a demo of a two-minute video made with the same skill. It then covers features by stage, installation, quick start, defaults, a script reference, limitations and security.
README badge
Original SKILL.md
--- name: showreel description: 한국어 모션그래픽 영상(이력서용 쇼릴·홍보 영상·프로필 영상·티저·브랜드 필름·행사 홍보·제품 소개·교육 영상·메이킹 필름)을 콘셉트부터 납품까지 만드는 스킬. 정해 둔 무드나 템플릿을 고르지 않는다. 요청마다 콘셉트 후보를 여러 개 세워 가장 강한 것을 고르고, 구간마다 아트 디렉션을 새로 정해 코드(DOM·캔버스·WebGL 셰이더·3D)로 화면을 만든 뒤, 렌더한 프레임을 직접 보며 약한 구간을 다시 만드는 일을 반복한다. 음악·효과음·ElevenLabs 나레이션·codex-image 이미지·믹스·자동 검수까지 끝낸다. 사용자에게는 사용자만 아는 사실(대상·꼭 넣을 정보·자료 위치)만 묻고, 무드·길이·구성·나레이션 여부 같은 창작 결정은 스스로 내린다. '쇼릴', '모션그래픽', '애니메이션 영상 만들어줘', '홍보 영상', '소개 영상', '인물 소개 영상', '1분 영상', 'N초 영상', '이력서용 쇼릴', '놀라운 모션 그래픽 디자이너', '전력을 다해요', '키네틱 타이포', '나레이션 넣은 영상', '티저 영상', '하네스가 어떻게 동작하는지 영상으로' 같은 요청이면 영상이라는 말이 없어도 이 스킬을 쓴다. 실사 촬영본 컷 편집, 파일 자르기·변환만 하는 작업, Sora·Veo 같은 생성형 비디오 모델 호출, 슬라이드·PDF만 만드는 작업은 범위가 아니다. --- # 모션그래픽 쇼릴 제작 ## 이 스킬이 맞추는 기준 이 스킬은 아래 요청에서 출발했다. > 당신이 얼마나 놀라운 모션 그래픽 디자이너인지 보여주는 역동적인 한글버전 1분 모션그래픽 비디오를 만들어 보세요. 이력서용 쇼릴 처럼요. 전력을 다해요. 요청의 각 부분이 결과물에 요구하는 것은 다음과 같다. | 요청 | 뜻 | 결과물에서 확인할 것 | | --- | --- | --- | | 당신이 얼마나 놀라운 모션 그래픽 디자이너인지 | 영상 자체가 만든 사람의 실력을 증명한다. 무엇을 말하는지보다 화면을 어떻게 만들었는지가 먼저 보인다 | 화면마다 템플릿으로는 나오지 않는 판단(구도, 움직임 설계, 재질)이 있다 | | 놀라운 | 보는 사람이 다음 화면을 예상하지 못한다 | 앞 구간과 다른 방식의 화면이 이어서 나온다. 구간마다 "어떻게 만들었지" 싶은 순간이 있다 | | 역동적인 | 빠르기만 한 영상이 아니다. 빠름과 멈춤, 큼과 작음의 대비가 음악의 박·섹션과 같은 시각에 바뀐다 | 몰아치는 구간과 비운 구간이 모두 있다. 실수로 멈춘 구간이 없고, 멈춤은 의도한 자리에만 있다 | | 한글버전 | 한글을 번역 자막이 아니라 디자인 재료로 쓴다 | 자모 구조, 획, 네모꼴, 가변 굵기 같은 한글의 형태가 움직임에 쓰인다 | | 이력서용 쇼릴 | 서로 다른 작업의 가장 좋은 구간을 음악에 맞춰 이어 붙이고 이름(과 연락처)으로 끝나는 형식 | 표현 범위가 넓다(2D·3D·타이포·데이터·사진·생성 그래픽 등). 구간마다 다른 프로젝트처럼 보인다 | | 전력을 다해요 | 첫 아이디어에서 멈추지 않고 시간과 반복을 아끼지 않는다 | 콘셉트 후보를 여러 개 비교한 기록과 약한 구간을 다시 만든 기록이 있다 | 다른 주제(제품 소개, 행사 홍보, 인물 프로필)에 이 문장이 붙어 오면 주제는 요청대로 따르고, 만드는 기준은 위 표를 따른다. 이 문장이 없는 요청에도 "놀라운·역동적인·한글버전·전력을 다해요" 기준은 그대로 적용한다. "구간마다 다른 프로젝트처럼 보인다"는 기준은 작업 모음 형식(쇼릴)일 때 적용한다. 브랜드·교육 영상처럼 한 작품으로 보여야 하는 영상은 한 영상 안의 일관성을 먼저 지키고, 매체와 움직임으로 장면을 나눈다. ## 정해 두지 않은 것 무드, 팔레트, 서체 조합, 장면 구성, 나레이션 여부는 요청마다 콘셉트 단계에서 정한다. 이 스킬의 이전 버전은 "어두운 배경 + 금색 강조 + 레터박스 + 필름 그레인 + HUD 모서리"를 기본값으로 두었고, 그 결과 주제가 달라도 영상이 비슷하게 나왔다. 이런 요소(`references/design.md`의 "뻔한 화면")는 콘셉트가 요구할 때만 의도해서 쓰고, 그 이유를 `concept.md`에 적는다. 스크립트·엔진·검수 도구는 그대로 쓴다. 도구는 화면의 모양을 정하지 않는다. 싱크, 결정성, 음량, 섬광 같은 기술 품질을 맞추는 데 쓴다. ## 기술 기본값 요청에 없는 항목은 아래 값으로 진행한다. | 항목 | 기본값 | | --- | --- | | 길이·규격 | 60초, 16:9 1920×1080, 30fps. 릴스·쇼츠 용도면 9:16 1080×1920 | | 나레이션 | 요청에 있거나 내용을 말로 전해야 할 때만 넣는다. 쇼릴은 음악과 화면으로 전한다. 넣을 때는 콘셉트에 맞는 보이스를 `references/audio.md`의 보이스 표와 `eleven.py voices --lang ko`에서 고른다. Marcus `ibCGc01503OQd2R6i1n1`은 한국어 낭독 설정(`eleven_multilingual_v2`, stability 0.45 · similarity 0.8 · style 0.4)을 검증해 둔 보이스다 | | 음악 | ElevenLabs Music(유료 플랜). 쓸 수 없으면 `synth_music.py` 합성 음악 | | 이미지 | 콘셉트에 필요할 때만 codex-image로 생성한다. 실존 인물의 얼굴은 생성하지 않고 실제 사진만 쓴다 | | 산출물 | 마스터 MP4, 공유용 MP4, 포스터 JPG, 자막 SRT(나레이션이 있을 때), 제작노트 | | 음량 | -14 LUFS. `mix.py`가 true peak -2.0 dBTP로 마스터링하고, 검수 기준은 -1.0 dBTP 이하다 | ## 작업 위치 모든 작업 파일은 프로젝트 폴더 아래에 만든다. `/tmp`, `/private/tmp`, 세션 scratchpad에는 아무것도 저장하지 않는다. 세션이 끝나면 임시 폴더가 지워져 재생성 명령·검수 시트·생성 이미지·나레이션 테이크를 다시 쓸 수 없게 된다. 검수용 스틸과 시트는 `<프로젝트>/qa/`, 중간 렌더는 `<프로젝트>/out/`에 둔다. 프로젝트 폴더는 사용자가 지정하지 않으면 현재 작업 폴더 아래에 영문 소문자 이름(`./<주제-slug>/`)으로 만든다. ## 진행 방식 ``` 0 환경 점검 → 1 요청 읽기(필요한 것만 질문) → 2 콘셉트 → 3 조사·자료 → 4 구성·원고 → 5 오디오 먼저(음악·효과음·나레이션 → 타임라인) → 6 이미지 → 7 스타일 프레임 → 8 장면 제작 → 9 초안 렌더·비평 반복 → 10 최종 렌더·믹스·마감 → 11 자동 검수·납품 보고 ``` 질문은 1단계에서 사용자만 아는 사실에 한해서 한다. 그 뒤로는 묻지 않고 납품까지 진행한다. 진행 중 막히는 일(보이스 불가, 음악 API 불가, 확인되지 않는 사실)은 아래 대체 경로로 처리하고 납품 보고에 적는다.