AI TOOLS | 무료 스킬
역사 다큐,클로드한테 부탁하세요세종대왕 66초 다큐를 직접 만든 기록
한 줄 부탁으로 대본·목소리·사진·효과음까지 코드로 만드는 무료 스킬 cinematic-skill. 공식 원문과 번역, 세종대왕 다큐를 직접 만든 화면, 영어 전용이던 효과 타이밍을 한국어로 고친 방법(바꾼 줄 그대로), 클로드에게 붙여 넣는 부탁 문장
유튜브에서 보던 코르크 벽 역사 다큐, 클로드에게 한 줄로 부탁할 수 있을까요? cinematic-skill은 “○○ 90초 다큐 만들어 줘” 한 줄이면 대본·목소리·사진 찾기·카메라 이동·효과음·자막까지 코딩 AI가 만드는 무료 스킬이에요. Ai.Mag가 세종대왕·훈민정음 다큐를 직접 만들었고, 원래 영어 전용이라 한국어에서 엇나가던 부분을 고친 방법까지 그대로 정리했어요.
한눈에
- 무엇코딩 AI(클로드 코드 등)에 설치하는 스킬. 한 줄 부탁 → 내레이션 다큐 영상
- 방식생성형 영상이 아니에요. 모든 장면을 코드로 그려서 매번 같은 결과, 고치기 쉬움
- 요금스킬은 무료(MIT). 11월 9일(한국 시간) 공개
- 우리 결과세종대왕 다큐 66초, 세로 1080×1920. 렌더는 약 1분(맥 M 시리즈)
- 핵심한국어 대본이면 효과가 한꺼번에 떠요 → 4개 파일을 고쳐야 해요 → 한국어로 고친 방법
공식 원문
README·SKILL.md 원문과 번역
- "Ask your agent for "a 90 second documentary about the Wright brothers" and it writes the script, records a voice, finds public-domain photos with their licences, and builds one continuous camera move over a single designed world."에이전트에게 "라이트 형제 90초 다큐"를 부탁하면 대본을 쓰고, 목소리를 녹음하고, 라이선스가 붙은 퍼블릭 도메인 사진을 찾고, 하나의 세계 위로 끊김 없는 카메라 이동을 만들어요.
- "Stamps slam, highlighters swipe and numbers roll up on the exact word the narrator says."내레이터가 그 낱말을 말하는 순간 도장이 쾅 찍히고, 형광펜이 그어지고, 숫자가 올라가요.
- "Nothing is generated video. Every frame is drawn by code (Skia, in Python), so the film renders the same every time, changes are cheap, and a new voice re-times the whole film by itself."생성형 영상은 하나도 없어요. 모든 프레임을 코드(파이썬 Skia)로 그려서 매번 똑같이 나오고, 고치기 쉽고, 목소리를 바꾸면 영상 전체 타이밍이 저절로 다시 맞춰져요.
- "Nothing invented that looks real. … A document drawn in code is labelled a recreation and quotes only words that were really written. AI images are fine for illustration, but never as evidence of a real event or a real person."진짜처럼 보이는 걸 지어내지 않는다. 코드로 그린 문서는 '재현'이라고 표시하고 실제로 쓰인 말만 인용한다. AI 이미지는 그림 설명용으로만, 실제 사건·인물의 증거로는 쓰지 않는다. (SKILL.md 규칙 7)
공식 설명의 6단계예요. 대본 표, 화면 분위기, 30초 시안이 나올 때마다 멈추고 확인을 받아요.
- 대본: 자료를 찾고 사실을 확인해 한 줄에 한 생각씩 써요.
- 목소리: 맥 기본 음성으로 먼저 타이밍을 잡아요. 나중에 다른 음성이나 사람 목소리로 바꿔도 돼요.
- 사진: 위키미디어 공용에서 찾아 받고, 사진마다 라이선스를 적어요. 자유 이용이 아닌 사진은 거절해요.
credits.md(출처 목록)를 알아서 써요. - 장면: 낱말마다 도장·형광펜·숫자를 붙이고 카메라를 움직여요.
- 점검: 정지 화면을 뽑아 스스로 실수를 찾아요.
- 마무리: 효과음을 직접 합성하고(라이선스 걱정 없음) 렌더, 자막 4가지 스타일과 SRT까지.
우리가 만든 다큐 (직접 실행)
11월 11일, 클로드 코드에 “5번 한번 해봐” 한 줄로 맡겼어요. 주제는 세종대왕과 훈민정음, 16줄 대본, 세로 1080×1920, 65.6초. 편집 프로그램은 한 번도 열지 않았어요.

① 대본: 실록·원문에 근거를 달아서
줄마다 근거 메모를 달았어요. 예) “1444년 2월, 집현전 부제학 최만리가 반대 상소” → 세종실록 26년 2월 20일 기사.

② 사진: AI로 그리지 않고 진짜 사료만 4장
| 사진 | 라이선스 |
|---|---|
| 훈민정음 해례본 | 퍼블릭 도메인 |
| 훈민정음 언해본 첫 장 | 퍼블릭 도메인 |
| 경복궁 근정전 (Brady Bellini) | CC0 |
| 광화문 세종대왕 동상 (대한민국 정부) | CC BY-SA 2.0 |
지도는 공개 지도 데이터로 그렸어요. 상소문·서문 같은 문서는 원문을 현대어로 옮겨 코드로 조판한 재현이에요.
③ 효과: 말하는 낱말에 맞춰




- 목소리는 맥 기본 음성 ‘유나’(시험용), 효과음 32개는 스킬이 직접 합성했어요.
- 렌더는 1968프레임에 약 1분 걸렸어요(맥 M 시리즈).
- 아쉬운 점: 자막 낱말 강조가 조금 어긋나고, 문서 글씨가 휴대폰에서 작아요.
한국어로 고친 방법
문제: 이 스킬은 “그 낱말이 몇 초에 나오나”를 글자 수 비율로 계산해요. 줄 전체 글자 중 그 낱말 앞에 글자가 몇 개 있는지 보고 시간을 나누는 식이에요. 그런데 영어 알파벳(A~Z)만 세요. 한국어 문장은 0글자로 계산돼서, 도장·형광펜이 줄 시작에 한꺼번에 떠요.
고친 것 (클로드가 직접): 영어만 세던 부분을 한글·숫자까지 세게 바꿨어요. 한글 한 글자는 소리 내면 영어 세 글자쯤 길어서 3글자로 쳐요. 파일 4개, 5군데예요.
| 파일 | 하는 일 |
|---|---|
engine.py |
낱말이 나오는 시각 → 도장·형광펜 타이밍 |
captions.py |
자막에서 낱말 강조 시각 |
make_beats.py |
녹음 전에 줄 길이 어림 |
split_takes.py |
녹음을 줄마다 자르는 기준 (2군데) |
모두 skills/cinematic-film/scripts/ 안에 있어요. 바꾼 줄 그대로예요(- 지운 줄, + 넣은 줄).
# engine.py (2군데, 같은 식)
- letters = re.sub(r"[^a-z]", "", vo.lower())
+ letters = re.sub(r"[\W_]", "", vo.lower())
- before = len(re.sub(r"[^a-z]", "", vo[:idx].lower()))
+ before = len(re.sub(r"[\W_]", "", vo[:idx].lower()))
# captions.py
- letters = len(re.sub(r"[^A-Za-z]", "", w))
+ letters = (len(re.sub(r"[\W_]", "", w)) + 2 * len(re.findall(r"[가-힣]", w)))
# make_beats.py
- dur = len(re.sub(r"[^A-Za-z]", "", l["spoken"])) / LPS
+ dur = (len(re.sub(r"[\W_]", "", l["spoken"])) + 2 * len(re.findall(r"[가-힣]", l["spoken"]))) / LPS
# split_takes.py (weight 함수, 그리고 letters = 줄)
- return len(re.sub(r"[^A-Za-z]", "", text)) + ...
+ return (len(re.sub(r"[\W_]", "", text)) + 2 * len(re.findall(r"[가-힣]", text))) + ...
- letters = len(re.sub(r"[^A-Za-z]", "", line["spoken"]))
+ letters = (len(re.sub(r"[\W_]", "", line["spoken"])) + 2 * len(re.findall(r"[가-힣]", line["spoken"])))[\W_]는 "글자·숫자가 아닌 것"이라 한글도 글자로 남아요. 뒤에 붙인 2 × 한글 수가 한글을 3글자로 치는 부분이에요. engine.py는 한 줄 안에서 비율만 쓰니 3배를 안 붙여도 돼요.
같이 바꾼 것 3가지
- 한글 글꼴: 기본 글꼴엔 한글이 없어요. 내 프로젝트 폴더의
fonts/에 한글 글꼴을cond.ttf,hand.ttf,label.ttf,labelm.ttf,mono.ttf,serif.ttf이름으로 넣으면 그걸 써요. 우리는 페이퍼로지를 넣었어요. - 한자 제목은 한글로: 글꼴에 한자가 없으면 네모로 깨져요. ‘訓民正音’ 대신 ‘훈민정음’.
- 맥 인증서 오류: 사진을 받다가 인증서 오류(
CERTIFICATE_VERIFY_FAILED)가 나면 파이썬 패키지 certifi로 풀었어요. 클로드에게 그대로 말하면 돼요.
설치
1단계. 스킬 설치 (Node 22.20 이상). 클로드 코드·코덱스·커서 등에 같이 깔려요. 끝나면 클로드 코드를 새로 열어요.
npx skills add Moh4696/cinematic-skill클로드 코드 플러그인으로 깔고 싶으면 클로드 코드 안에서 아래 두 줄을 넣어요.
/plugin marketplace add Moh4696/cinematic-skill
/plugin install cinematic-skill@cinematic-skill2단계. 그림 그리는 파이썬 패키지 + ffmpeg
pip install skia-python numpy pillowffmpeg도 있어야 해요(맥은 brew install ffmpeg). 스킬 안의 check_setup.py가 빠진 걸 알려 줘요. 우리는 컴퓨터 전체에 깔지 않고 시험 폴더의 가상환경에만 깔았어요.
그대로 붙여 넣는 부탁 문장
대괄호만 바꿔서 클로드 코드에 넣어요.
① 처음 만들 때 (한국어 고치기까지 한 번에)
cinematic-skill로 [주제] [90]초 다큐 만들어 줘. 세로 1080x1920. 한국어 대본이니 시작 전에 글자 세는 부분을 한글도 세게 고쳐 줘: engine.py, captions.py, make_beats.py, split_takes.py에서 영어 알파벳만 세는 부분을 한글·숫자도 세게 바꾸고, 한글 한 글자는 영어 3글자로 쳐 줘(engine.py는 한 줄 안 비율만 쓰니 3배는 안 붙여도 돼). 프로젝트 fonts/에 한글 글꼴 [페이퍼로지]를 cond·hand·label·labelm·mono·serif.ttf 이름으로 넣고, 한자 제목은 한글로 써 줘. 사진은 위키미디어 공용의 자유 이용 사진만, 출처는 credits.md에. 전역 설치 말고 이 폴더 가상환경에만 깔아 줘.② 대본 사실 확인
대본 줄마다 근거 출처를 달아 줘. 역사는 [조선왕조실록·국가유산청] 같은 공식 출처로 날짜를 확인하고, 확인 못 한 줄은 빼거나 표시해 줘. 코드로 그린 문서는 '재현'이라고 적고 실제로 쓰인 말만 옮겨 줘.③ 다 만든 뒤 고칠 때
[12]초쯤 [도장]이 낱말보다 [먼저] 떠. "[한자뿐]"을 말하는 순간에 맞춰 줘. 고친 뒤 그 장면 정지 화면을 뽑아서 보여 줘.알아 둘 것
- 고친 건 공식 판이 아니에요. 스킬이 업데이트되면 다시 고쳐야 할 수 있어요. 위 ① 부탁 문장을 매번 넣으면 돼요.
- 목소리는 시험용이었어요. 맥 기본 음성은 어색해요. 공식 설명대로 다른 음성이나 내 목소리로 바꾸면 타이밍이 저절로 다시 맞춰져요.
- 문서 글씨가 휴대폰에서 작아요. 세로 영상이면 문서를 크게 하라고 따로 부탁하세요.
- 사진 라이선스는 credits.md를 꼭 보세요. CC BY-SA 사진은 출처를 적어야 해요.
출처
- 저장소·README: https://github.com/Moh4696/cinematic-skill
- 스킬 규칙(SKILL.md): https://github.com/Moh4696/cinematic-skill/blob/main/skills/cinematic-film/SKILL.md
- 세종실록 26년(1444) 2월 20일 최만리 등 상소: https://sillok.history.go.kr/id/kda_12602020_001
- 훈민정음 해례본(1940년 안동 발견, 1997년 10월 세계기록유산): https://www.heritage.go.kr/heri/html/HtmlPage.do?pg=/unesco/MemHeritage/MemHeritage_01.jsp
- 영상 속 사진: 해례본(퍼블릭 도메인) · 언해본(퍼블릭 도메인) · 근정전, Brady Bellini(CC0) · 세종대왕 동상, 대한민국 정부(CC BY-SA 2.0)