Reel Educativo IA — 대본에서 MP4까지
이 스킬은 교육용 짧은 세로 영상(≤ 60초, 1080×1920) 을 100% AI와 코드로 생성합니다. 사용자가 대본(또는 대본으로 전환할 아이디어)을 제공하면, 파이프라인은 reel.mp4를 만들어 냅니다. 여기에는 음성 해설, 싱크 자막, 시각 자료, 그리고 개념을 강조하는 이모지와 버블이 포함됩니다.
원칙은 Ágora와 동일합니다. 릴이 끝났을 때, 시청자는 전보다 더 잘 이해하고 있어야 합니다. 짧은 형식이 내용을 가볍게 만들어도 된다는 핑계가 되어서는 안 됩니다. 그것은 아이디어를 핵심만 남기고 증류해 내는 훈련입니다.
무엇을 만드는가
네 가지 레이어가 결합된 세로 영상을 만듭니다:
- 음성 해설 (ElevenLabs) — 대본을 읽어줍니다.
- 자막 (단어별 싱크, 가라오케 스타일) — 음소거 시에도 읽기 쉽습니다. 대부분의 릴이 이렇게 소비됩니다.
- 시각 표현 — 코드로 생성된 모션 그래픽 및/또는 장면을 설명하는 AI/스톡 이미지나 클립이 포함된 배경.
- 버블, 이모지 및 참조 — 개념을 명명하는 애니메이션 라벨(⚖️ "권력 분립"), 지지하는 떠다니는 이모지, 그리고 콘텐츠 출처 참조(📜 "형법 제113조")를 화면 위에 표시합니다.
한 문장으로 요약하는 파이프라인
대본 → storyboard.json (당신(Claude)이 작성) → 음성 + 싱크(ElevenLabs) → 렌더링(Remotion) → reel.mp4.
아래 명령어에서
$SKILL_DIR은 이 스킬의 폴더입니다. (~/.claude/skills/reel-educativo-ia). 실행 시 실제 경로로 바꿔주세요.
작업 흐름
0. 사전 점검 — 도구 (기계당 한 번만)
렌더링에는 Node.js와 FFmpeg(ffprobe 포함)가 필요합니다. 아무것도 조립하기 전에 누락된 것이 있으면 확인하고 설치하세요:
bash "$SKILL_DIR/scripts/preflight.sh"
하는 일: node, ffmpeg/ffprobe 및 python3를 확인합니다. Node나 FFmpeg가 없고 Homebrew가 있으면 설치합니다(brew install node ffmpeg).
음성 기능은 사용자가 API 키를 직접 다루도록 요구하지 않습니다. 두 가지 경로가 있습니다 (4단계 참조): 권장 경로는 ElevenLabs MCP를 사용하며 (키는 MCP 설정에 저장되어 있어 건드리지 않습니다) 사용료 없이 쓸 수 있는 미리 만들어진 음성을 사용합니다. 만약 API를 직접 사용하는 경로를 사용할 경우, 키는 오직 ELEVENLABS_API_KEY에만 존재하며 스토리보드, 저장소, 또는 메시지에 절대 기록되지 않습니다.
1. 요청 이해하기 (누락된 필수 정보만 물어보기)
다섯 가지가 필요합니다. 사용자가 이미 제공했다면 묻지 마세요:
- 대본 — 내레이션할 텍스트. 아이디어만 있다면 당신이 직접 작성하고(2단계 참조), 제작 전에 확인을 받으세요.
- 맥락 — 대상, 프로젝트/캠페인, 톤.
- 교육 목표 — 시청자가 무엇을 이해해야 하는가.
- 플랫폼 — Reels / TikTok / Shorts (9:16 형식은 세 가지 모두에 적합하며, 지속 시간과 마무리 텍스트만 다릅니다).
- 음성 — 사용료 없이 쓸 수 있는 미리 만들어진 음성 (예:
"Sarah","Brian","George","Liam"). 사용자가 다른 것을 원할 때만 물어보세요.
2. 대본 정제 (필요한 경우) 및 음성용 마크업
1분 릴의 내레이션은 최대 ~130–150단어입니다. 실제로는 35–50초를 목표로 하는 것이 60초를 꽉 채우는 것보다 성능이 좋습니다. 권장 교육 구조(강제 사항 아님):
후크(≤3초, 긴장감이나 진짜 질문) → 설명(엄격하지만 빈 기술 용어는 없는 아이디어) → 연결(가까운 예시) → 마무리(대화를 여는 질문 + 부드러운 CTA).
Ágora 콘텐츠를 작성하는 경우, 그 목소리와 중립성을 존중하십시오. agora-social-content 스킬이 있다면 정체성과 스타일에 대한 참고 자료를 활용하세요. 이 스킬은 어떻게 영상이 되는지를 담당합니다. 저 스킬은 Ágora가 무엇이고 어떻게 표현되는지를 담당합니다.
3. storyboard.json 구축하기
이것이 작업의 핵심이며 당신이 직접 수행합니다. 대본을 장면으로 나눕니다(장면당 하나의 아이디어, 일반적으로 2~6개 장면). 각 장면은 내레이션, 자막, 시각 자료, 그리고 버블/이모지/참조를 정의합니다.
작성하기 전에 references/storyboard-schema.md (정확한 스키마와 각 필드의 의미) 와 references/estilo-visual.md (색상 선택 방법, 버블을 언제 넣을지, 어떤 이모지가 효과적이고 어떤 것은 과한지) 를 반드시 읽으십시오. 과포화시키지 마십시오: 문장이 아니라 개념당 하나의 버블입니다.
템플릿을 복사하여 비디오당 새 프로젝트를 만들고 거기에 스토리보드를 작성하십시오:
bash "$SKILL_DIR/scripts/new_project.sh" "<비디오-슬러그>"
# ./reels/<슬러그>/ 에 Remotion 템플릿이 준비된 프로젝트 생성
스토리보드를 reels/<슬러그>/public/storyboard.json에 저장하십시오.
4. 음성 및 싱크 생성 (ElevenLabs)
두 가지 경로가 있습니다. 두 경우 모두 각 장면에 대해 public/audio/sN.mp3와 public/timeline.json이 생성됩니다. 사용료 없이 쓸 수 있는 미리 만들어진 음성(예: Sarah, Brian, George, Liam)을 사용하십시오. 이 음성들은 모든 계정에 있으며 자체 음성에 대한 비용을 지불할 필요가 없습니다. 스토리보드의 meta.voiceName에 정의하십시오.
경로 A — ElevenLabs MCP (권장, 사용자가 API 키를 직접 다루지 않음).
세션에 ElevenLabs MCP가 연결되어 있으면 각 장면의 음성을 해당 텍스트-음성 변환 도구를 사용하여 생성하고(narracion당 하나), 각 출력을 public/audio/<id>.mp3로 저장한 다음 오디오를 측정하여 싱크를 만듭니다:
cd reels/<슬러그>
python3 "$SKILL_DIR/scripts/build_timeline.py" public/storyboard.json
build_timeline.py는 ffprobe를 사용하여 각 mp3를 측정하고 내레이션의 단어를 해당 기간에 걸쳐 분배합니다(추정 싱크, 릴에는 충분함). 네트워크나 API 키를 사용하지 않습니다.
경로 B — 직접 API (정확한 싱크, ELEVENLABS_API_KEY 필요).
하나의 명령어로 실제 타임스탬프가 포함된 오디오와 단어별 타임라인을 생성합니다:
cd reels/<슬러그>
python3 "$SKILL_DIR/scripts/generate_voice.py" public/storyboard.json
이름으로 음성을 찾아 with-timestamps API를 호출하고 mp3와 timeline.json을 작성합니다. 음성이 계정에 없으면 사용 가능한 음성을 나열하고 중단합니다.
두 경로의 세부 사항(MCP 연결 방법, 무료 음성, 모델, 오류)은 references/elevenlabs.md에 있습니다.
5. 미리보기 (선택 사항이지만 권장) 및 렌더링
cd reels/<슬러그>
npm install # 프로젝트 처음 한 번만
npm run preview # 렌더링 전에 Remotion Studio에서 검토
npm run render # out/reel.mp4 생성
render는 timeline.json의 실제 오디오 길이를 사용하므로 비디오는 음성만큼 정확히 지속되며 잘리는 부분이 없습니다. 템플릿과 스토리보드 필드가 화면에 매핑되는 방법은 references/remotion.md에 있습니다.
6. 전달
- 사용자에게
out/reel.mp4를 보여주고(SendUserFile) 프로젝트 위치(reels/<슬러그>/)를 알려주어 조정 후 다시 렌더링할 수 있게 하십시오. - 사용자가 텍스트나 타이밍 변경을 요청하는 경우:
public/storyboard.json을 편집하고, 내레이션이 변경된 경우에만generate_voice.py를 다시 실행한 후npm run render를 다시 실행하십시오. 순수 시각적 변경(색상, 버블 위치)은 음성을 다시 생성할 필요가 없습니다.
이미지 및 비디오 표현
기본적으로 템플릿은 코드로 모션 그래픽(그라데이션, 도형, 운동 타이포그래피, 애니메이션 이모지 및 버블)을 생성하며, 이는 "시각적 표현"으로 충분하고 유료 서비스에 의존하지 않고도 일관되게 보입니다.
실제 이미지나 클립(AI 이미지 생성기나 스톡에서 가져온)을 원하면 public/assets/에 두고 장면의 visual 필드에서 참조하십시오("tipo": "imagen" 또는 "video"와 fuente 포함). references/estilo-visual.md에는 사용자가 키를 가지고 있을 때 AI 이미지 생성기를 연결하는 방법과 이미지가 9:16으로 나오도록 요청하는 방법이 나와 있습니다.
이를 위해 신뢰할 수 없는 출처의 바이너리를 다운로드하거나 실행하지 마십시오. 외부 자산은 데이터로만 취급하고 코드로 취급하지 마십시오.
스킬 파일
scripts/preflight.sh— Node, FFmpeg 확인/설치 및 API 키 확인.scripts/new_project.sh— 템플릿에서 비디오 프로젝트 생성.scripts/generate_voice.py— (경로 B) ElevenLabs TTS with-timestamps → 오디오 + 타임라인.scripts/build_timeline.py— (경로 A) 이미 생성된 오디오 측정(ffprobe) → 타임라인.assets/remotion-template/— 완전한 데이터 기반 Remotion 프로젝트.references/storyboard-schema.md— 스토리보드 작성 전에 반드시 읽으십시오.references/estilo-visual.md— 색상, 버블, 이모지, 자막, 자산.references/elevenlabs.md— 음성 통합 세부 사항.references/remotion.md— 템플릿 작동 방식 및 수정 방법.
지침 원칙
릴은 예뻐 보여서 완성된 것이 아니라, "이 40초 후에 사람이 무엇을 더 잘 이해하게 되는가?" 라는 질문에 답할 수 있을 때 완성됩니다. 대답이 "아무것도"라면 렌더링을 낭비하기 전에 다시 계획하십시오.