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.}

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에 있습니다.

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

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.

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.

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.

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 paths are available (narration, music API, image generation).

Open Claude Code in an empty folder and describe the video. The skill triggers on requests such as "showreel", "motion graphics", "promo video", "teaser", "60-second video", or by typing /showreel.

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

/showreel 우리 팀이 만든 사내 검색 서비스 소개 60초 영상. 웅장한 분위기, 나레이션 넣어 줘.

Make a 30-second product teaser in Korean, tech keynote style, music and typography only, no narration.

Claude asks only for facts it cannot find (for example, the exact event date), picks the concept itself, tells you the chosen concept in a line or two, and runs to delivery without waiting for confirmation. When Claude itself is the subject — the showreel request above — it asks nothing.

A finished project looks like this:

my-promo/
├── concept.md, storyboard.md, script.json, timeline.json
├── research/        research.md (facts with sources), photos.md
├── audio/           vo/ (narration takes), music/, sfx/, mix.wav
├── assets/          gen/ (generated images), img/ (processed)
├── reel/            index.html, engine.js, fx.js, timeline.js, scenes.js, fonts/
├── qa/              stills, contact sheets, critique_NN.md, qa_report.md
├── out/             <title>.mp4, <title>_공유용.mp4, poster, .srt
└── 제작노트.md       production note

Anything you do not specify uses these values.

All scripts live in scripts/. Claude runs them for you; the table is for reference and manual reruns.

showreel/
├── SKILL.md             Skill entry point read by Claude (workflow, defaults, rules)
├── references/          Detailed guides loaded per step
│   ├── brief.md         What to ask, concept candidates and concept.md template, research prompt, time/credit estimates
│   ├── story.md         Structures by purpose and length, copy and pronunciation rules
│   ├── audio.md         Voices, ElevenLabs plans, music, SFX, mix targets
│   ├── images.md        Image generation, real photos, cutouts
│   ├── design.md        Art direction, the template look to avoid, motion principles, rhythm, Korean typography
│   ├── engine.md        Engine API, scene authoring, WebGL & 3D, splitting work across agents
│   ├── techniques.md    22 techniques with code
│   └── qa.md            Critique, review checklist, delivery report template
├── scripts/             Python, Node and shell tools listed above
├── assets/
│   ├── engine/          engine.js, fx.js, index.html, scenes.js (API sample, copied to projects as _example_scenes.js)
│   └── sfx_presets.json SFX prompt presets
├── evals/evals.json     Evaluation prompts and assertions used to develop the skill
└── docs/media/          README media

More cases are listed in SKILL.md and each file in references/.

• Claude cannot listen to audio. Loudness, narration-vs-bed ratios, reverb tails and STT are checked numerically. Listen to the result before publishing.
• Written for Korean narration and typography. Other languages need new script and pronunciation rules.
• ElevenLabs usage costs credits. Commercial use follows your ElevenLabs plan terms.
• Faces and bodies of real people are never generated. Use real photos with permission.
• Developed and tested on macOS. Cutouts depend on macOS Vision.

Contributions are welcome. Read CONTRIBUTING.md for the development setup, the evaluation prompts in evals/ and the pull request checklist. This project follows the Code of Conduct.

Never commit API keys, .env files or generated narration that you do not have rights to publish. To report a vulnerability, follow SECURITY.md.

Released under the MIT License.

Media in docs/media/ and the demo video were produced with this skill. The demo includes frames from the author's own earlier reels, ElevenLabs voices and music, and AI-generated images; the people in the theater shot are AI-generated and their faces are not visible.

• Playwright for driving headless Chrome
• ElevenLabs for TTS, STT, Music and SFX APIs
• Pretendard and Google Fonts (Noto Serif KR, Black Han Sans, Anton, JetBrains Mono), all under the SIL Open Font License
• FFmpeg for encoding and loudness measurement

showreel is an independent project and is not affiliated with or endorsed by Anthropic, ElevenLabs or OpenAI.