Communitygithub.com

스크립트 기반 비디오 제작

스크립트(데이터 및 코드, 타임라인 편집 아님)로 작성된 비디오를 계획, 조사, 작성, 검토하고 mp4로 내보냅니다. 사용자가 비디오, 튜토리얼, 설명, 강의, 코스 모듈, 제품 워크스루, 방법 가이드, 애니메이션 프레젠테이션, 유튜브 비디오, 짧은 세로 클립 또는 인앱 튜토리얼을 만들고 싶어하거나, '비디오용' 주제 조사, 비디오 스크립트 작성 또는 검토, 내레이션, 자막, 챕터, 음성 해설, 효과음, 음악 또는 번역 추가, 이 방식으로 만든 비디오 개선 또는 수정, 문서, 강의 또는 슬라이드 데크를 비디오로 변환을 요청할 때 사용합니다.

스크립트 기반 비디오 제작란 무엇인가요?

이 스킬은 텍스트 기반 스크립트를 사용하여 전체 비디오 제작 워크플로우를 구성하고 자동화합니다. 사용자가 비디오 제작을 요청하면, 브리핑 작성부터 조사, 마인드맵, 스토리보드, 스크립트 작성, 정확성 및 이해도 검토, 시각적 검토, 음성 및 사운드 추가, 최종 내보내기까지 13단계의 정형화된 프로세스를 안내합니다. 비디오는 JSON 또는 JavaScript 파일로 작성되며, 작은 엔진(starter/)이 이를 브라우저에서 렌더링하고, ffmpeg를 사용하여 mp4, 자막(SRT/VTT), 챕터를 포함한 최종 파일을 생성합니다. Claude Code, Cursor, Codex와 같은 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, Node.js 18+, Chrome/Edge/Chromium, ffmpeg만 있으면 됩니다. 주요 특징으로는 '핵심 깊이에서 전달하고 한 단계 더 깊이 조사하기', '모든 실제 예제는 주제를 직접 보여주어야 함', '조사에 명확한 경계와 종료 지점이 있음'이라는 세 가지 원칙에 기반하여, 요청자가 수정할 필요가 없는 완성도 높은 비디오를 제작하는 것을 목표로 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utoappia/skill-tutorial_video_creation/tree/HEAD/skills/scripted-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

스크립트 기반 비디오

여기서 비디오는 스크립트입니다. 무엇이 말해지고, 무엇이 화면에 표시되며, 언제 표시되는지를 정의하는 파일입니다. 작은 엔진(starter/ 안에 있음)이 이를 브라우저에서 그림으로 바꾸고, 소리, 자막, 챕터가 포함된 .mp4로 변환합니다. 비디오가 텍스트이기 때문에, 작성하고, 확인하고, 줄 단위로 검토하고, 모든 프레임을 살펴보고, 번역하고, 다시 편집할 필요 없이 한 단어를 수정할 수 있습니다.

엔진은 쉬운 부분입니다. 가르치는 비디오는 시청자가 따라올 수 있는 순서로, 그들이 아는 단어로, 목소리가 지칭하는 것을 가리키는 그림과 함께 진실된 이야기를 전달해야 합니다. 이 스킬의 대부분은 그 부분에 관한 것입니다. 단계를 순서대로 따르십시오. 각 단계는 다음 단계가 읽을 파일을 남기므로, 긴 세션에서도 작업이 유지되고 다른 에이전트가 이어받을 수 있습니다.

요청자가 수정할 필요가 없는 비디오를 전달하는 것을 목표로 하세요. 요청자의 시간이 당신이 절약하는 비용입니다. 따라서: 결정할 수 있는 것은 결정하고 그 결정을 기록하십시오. 요청자가 제공한 모든 서비스, 키, 사실을 사용하십시오. 전달하기 전에 요청자가 비디오를 보는 방식으로 살펴보십시오("전달하기 전에" 참조). 요청자가 가장 먼저 알아차리는 것은 거의 검사 도구가 찾아낼 수 있는 규칙 위반이 아닙니다. 비디오가 결코 답하지 않은 추측, 실제 내용이 없는 주제, 그리고 미완성처럼 들리는 비디오입니다.

세계에 관한 모든 비디오에 적용되는 세 가지 원칙이 있습니다. 각각은 여기에 한 번씩 명시되어 있습니다. 아래 단계에서 이를 적용하며 references/research.md는 방법을 제공합니다.

  • 핵심 깊이로 전달하고, 한 단계 더 깊이 조사하십시오. 당신이 전달하는 비디오는 핵심입니다. 약속을 지키고 진실되며 공정한 가장 짧은 설명입니다. 실제 이야기가 있는 주제의 경우 약 10~20분, 단일 메커니즘의 경우는 더 짧습니다. 요청자가 지정한 길이는 제한이며 우선합니다. 그러면 조사 깊이가 그에 따라 줄어듭니다. 조사는 세부 사항의 깊이로 한 단계 더 나아갑니다(사람들, 결정적인 날들, 정확한 수단, 경쟁 수치, 조사 결과). 이는 핵심이 지식을 바탕으로 선택되고, 인접 주제가 나타나도록 하기 위함입니다. 즉, 주요 주제와 관련되고 그 자체로 이야기가 있는 사건, 기관 또는 아이디어입니다. 각각은 이미 알려진 내용과 함께 research/next-videos.md의 행이 되며, 더 이상 조사되지 않습니다. 세부 사항 아래(각 인물의 이후 삶, 각 문서 전체, 기관의 전체 역사)에는 다른 비디오의 조사가 있습니다. 한 작업에서, 그렇게 하면 요청자가 원했던 18분 핵심이 6시간 비디오로 커졌습니다. 더 긴 버전은 요청이 있을 때만 만듭니다.
  • 모든 실제 예제는 주요 주제가 실제로 작동하는 모습을 보여줍니다. 실제 이야기는 비디오가 다루는 대상이 소스가 전하는 대로 실제로 그 이야기 안에서 발생하는 경우에만 비디오에 포함됩니다. 선물 시장에 관한 비디오의 경우, 거래소에서 거래된 선물 계약, 증거금 콜, 청산된 계약이 이에 해당합니다. 근처에만 있는 이야기(같은 시기, 유명한 이름, 비슷해 보이지만 다른 방식으로 이루어진 베팅)는 아무리 유명하고 요청자가 제안했더라도 제외됩니다. 이는 1차 조사에서 소스를 확인하고, 깊이를 투자하기 전에 이루어져야 합니다. 한 작업에서, 선물 비디오를 위해 제안된 가장 유명한 이야기는 은행과의 개인 거래를 통한 베팅으로 밝혀졌습니다. 두 판에서 이야기를 한 후에 제거되었습니다. 하지만 짧다고 해서 얇은 것은 아닙니다. 핵심에서 각 실제 예제는 그 사람들, 날짜, 정확한 수단, 금액, 어떻게 반대 방향으로 흘러갈 수 있었는지, 어떻게 끝났는지, 그리고 주요 주제에 대해 무엇을 보여주는지와 함께 전달됩니다.
  • 조사에는 경계와 종료 지점이 있습니다. 모든 단서는 검색에 투자하기 전에 주요 주제에 대해 테스트됩니다. 실패한 단서는 한 줄로 기록되고 남겨집니다("흥미롭다"고 해서 열지 않습니다). 세 번의 계획된 라운드(개요, 세부 사항, 그리고 비디오가 말할 모든 것의 이중 확인)와 핵심에 필요한 명명된 항목만을 위한 짧은 네 번째 라운드가 있습니다. 더 많은 것은 요청자의 결정입니다.

기본 시청자: 주제를 처음 접하는 사람입니다. 8세 어린이가 따라갈 수 있도록, 어른이 유치하다고 느끼지 않을 차분하고 전문적인 어조로 작성하십시오. 단순함은 유치함과 같지 않습니다. 짧은 문장, 일상적인 단어, 한 번에 하나의 아이디어, 애기 말투는 금물입니다. 브리핑이 다른 시청자를 명시하는 경우에만 이를 변경하십시오.

설정

이 스킬의 starter/ 폴더를 사용자의 프로젝트로 복사하고(예: video/), 다음을 실행하십시오.

cd video
npm install            # 작은 종속성 하나; 이미 설치된 Chrome을 사용합니다.
node tools/check.mjs   # 예제 비디오가 통과해야 합니다.

필요 사항: Node 18 이상; Chrome, Edge 또는 Chromium(그림 그리기); ffmpeg(음성 녹음 및 내보내기). 하나라도 없으면 references/troubleshooting.md를 참조하십시오. 스킬 폴더 자체 내에서 작업하지 말고 복사본에서 작업하십시오.

복사본에는 하나의 예제인 videos/hello.json이 포함되어 있습니다. 15초 분량의 일반 데이터로, 번역과 세로 레이아웃이 포함되어 있으며 설정이 작동하는지 확인하는 데 사용됩니다. 각 단계에서 무엇을 생성해야 하는지는 node tools/new.mjs가 생성하는 파일에 있습니다. 모든 파일은 자체 체크리스트로 시작합니다. 사용자 고유의 비디오 작업이 진행 중일 때 예제를 삭제하십시오.

단계

모든 비디오는 node tools/new.mjs <id> "<Title>"로 시작하십시오. 이 명령은 notes/<id>/(아래에 이름이 지정된 파일과 해당 체크리스트 포함)와 videos/<id>.mjs의 스크립트 뼈대를 생성합니다.

#단계생성물완료 조건참고 문서
0브리핑notes/<id>/brief.md시청자, 약속("시청 후, 시청자는 ...을 할 수 있다"), 길이, 형태, 언어가 기록되고, 요청자가 이름을 지정하여 요청한 모든 것이 포함됩니다.아래
1조사 방법research/00-how-to-research.md이 분야를 아는 사람들이 어떻게 정보를 찾고, 초보자가 어디서 실수하는지 알게 됩니다.references/research.md
2조사, 세 라운드research/NN-name.md, research/leads.md, research/next-videos.md, research/index.mdleads.md의 모든 단서가 종결됨(조사됨, 찾을 수 없음, 다음 비디오, 주제 외 또는 열림). 각 실제 예제가 예제 테스트를 통과하고 세부 사항의 깊이까지 알려짐. 다른 관점과 오해가 조사됨. 3라운드에서 비디오에 포함될 각 주장의 소스를 다시 읽고, 각각 소스와 신뢰도 레이블이 있음. 요청자가 기억하는 내용에 대한 판정이 있음. 전체 목록: references/research.md, 섹션 11.references/research.md
3마인드 맵mindmap.json조사된 모든 아이디어가 core(비디오에 포함), support(조사되고 참이지만 핵심에서 제외), 또는 cut(확인되지 않음, 불공정 또는 주제 외)임. core 아이디어만으로 약속이 유지됨. node tools/mindmap.mjs <id>가 오류 없음을 보고함.references/planning.md
4스토리보드storyboard.md, assets.md모든 비트에 그림, 요지, 컴포넌트 및 소리(보통 없음)가 있음. 하단의 확인 사항이 모두 체크됨.references/planning.md
5스크립트videos/<id>.mjsnode tools/check.mjs <id>가 오류 없음을 보고하고 모든 경고를 읽었음. 스크립트가 핵심 길이에 있음.references/authoring-kit.md, references/components.md
6정확성 검토review/accuracy.md, research/index.md (전체 설명만 review/coverage.md)dump --claims의 모든 행에 판정과 소스가 있음. 각 실제 이야기에 대해 작성자가 아닌 검토자가 스크립트, 노트 및 소스를 비교함(또는 두 번째 에이전트가 없는 경우, 직접 비교하고 파일에 "독립적이지 않음"이라고 명시). 핵심에 필요했고 부족했던 내용이 이제 포함되도록 연구가 스크립트와 대조하여 다시 읽혀짐. 수정 사항이 노트에 기록됨.references/script-review.md
7이해도 검토review/WhatIHaveLearned.md, review/lost-points.md일기가 약속에 도달하는 데 공백이 없고, 놓칠 수 있는 모든 방법에 대한 수정 사항 또는 이유가 있음.references/script-review.md
8시각적 검토review/visual.md모든 스틸 이미지를 살펴보았고 잘리거나, 가려지거나, 비어 있거나, 읽을 수 없는 것이 없음.references/visual-review.md
9음성 및 사운드out/tts/에 녹음된 라인, assets/<id>/의 사운드스크립트가 6~8단계를 통과했고 음성이 녹음됨. 이제 타이밍이 실제 음성을 따름. 이벤트 사운드가 설정됨. 음악(있는 경우)은 스토리 부분 아래에만 위치함.references/voice-and-assets.md
10내보내기 및 최종 시청out/<id>.mp4, .srt, .vtt, .chapters.txt내보낸 파일 자체의 프레임을 살펴보고 사운드를 확인함.references/export-and-publish.md
11다른 언어 및 형태 (요청 시)videos/i18n/<id>.<lang>.json각 언어가 check를 통과하고 해당 스틸 이미지를 살펴봄.references/localization.md
12게시 키트publish.md제목, 설명, 챕터, 자막, 썸네일, 출처 및 크레딧이 준비됨.references/export-and-publish.md
13전달요청자에게 보내는 메시지요청자의 관점에서의 점검이 완료됨. 메시지에 결정된 사항, 수정된 사항 및 아직 열려 있는 사항이 명시됨.references/finishing-and-revising.md

4단계부터 적용되는 작성 규칙은 references/writing-for-everyone.md(단어 및 문장)와 references/teaching-techniques.md(아이디어를 전달하는 방법)에 있습니다. references/visual-design.md는 레이아웃, 색상 및 동작을 다룹니다. 첫 번째 스크립트를 작성하기 전에 이 세 가지를 읽으십시오.

0단계: 브리핑

사용자가 말한 내용을 바탕으로 brief.md를 작성하십시오. 그 외의 모든 것은 가장 좋은 가정을 작성하고 "(가정됨)"이라고 표시하십시오. 묻기 위해 멈추지 마십시오("결정하고, 기록하고, 계속 진행" 참조). 가장 중요한 한 줄은 약속입니다. "시청 후, 시청자는 ...을 할 수 있다"로 시작하는 한 문장입니다. 이후의 모든 결정(무엇을 조사할지, 무엇을 생략할지, 비디오가 언제 완료되었는지)은 이에 대해 테스트됩니다. 또한 시청자가 이미 알고 있는 내용을 기록하십시오. 비디오는 그 지점에서 시작하기 때문입니다.

요청자가 이름을 지정하여 요청한 모든 것을 요청자의 말 그대로 브리핑에 복사하십시오: 사용할 서비스, 키 및 위치, 포함할 예시 또는 사건, 기억하는 사실, 혼란스러워하는 부분, 제한 사항("대부분 음악 없이"). 이 각각은 전달하기 전에 확인해야 할 항목입니다. 명명된 서비스는 지금(9단계가 아닌) 연결 가능한지 확인합니다. 요청자가 기억하는 사실은 반복할 내용이 아니라 확인할 내용으로 연구에 들어갑니다.

연구가 필요한지 여부를 여기서 결정하십시오. 콘텐츠가 완전히 제공된 경우(사용자 자신의 제품, 직접 작성한 스크립트, 설명한 프로세스)에만 1단계와 2단계를 건너뛰고 자체적인 사실을 추가하지 마십시오. 숫자, 날짜, 이름 또는 "왜냐하면"을 하나라도 추가한다면, 그것을 조사하십시오.

1단계 및 2단계: 조사

주제를 조사하기 전에 조사하는 방법을 조사하십시오. 사람들이 이 분야를 어떻게 배우고 조사하는지, 한 단계 위(채권 시장의 경우: "채권 시장을 이해하는 방법", 그 다음 "경제에 대해 배우는 방법")에 대해 두세 번 검색하십시오. 이는 어떤 출처가 중요하고, 어떤 숫자가 중요하며, 초보자가 어디서 실수하는지 알려줍니다. 그런 다음 세 라운드를 진행합니다.

  1. 개요. 주제당 하나의 노트, 상단에 요약 포함: 출처가 있는 사실, 실제 사건(먼저 예제 테스트를 통과한), 일상적인 비교, 그리고 주류와 동일한 주의로 조사된 가장 강력한 반대 관점과 오해.
  2. 세부 사항. 노트가 설명 없이 언급하는 모든 사람, 장소, 날짜, 숫자, 용어, 메커니즘, 원인 및 인용문을 research/leads.md에 나열하십시오. 주요 주제와 관련된 것들을 세부 사항의 깊이까지 한 번 조사하십시오. 인접 주제는 next-videos.md로 이동합니다. 나머지는 주제 외로 표시됩니다.
  3. 이중 확인. 새로운 주제는 없습니다. 비디오가 말할 모든 것을 해당 출처에서 다시 읽으십시오. 놀라운 주장, 이야기의 규모를 보여주는 숫자, 인용문, 그리고 지명된 사람에 대해 나쁘게 반영하는 모든 것에 대해 두 번째 독립적인 출처를 찾으십시오.

검색을 시작하기 전에 계획하고 세 번째는 3라운드를 위해 남겨두십시오. 다른 에이전트를 시작할 수 있다면 각 실제 사건을 자체 에이전트에 할당하고, 이중 확인은 노트를 작성하지 않은 에이전트에 할당하십시오.

완성된 비디오가 활용할 수 있어야 하는 두 가지 사항:

  • 세부 사항의 깊이까지 알려진 실제 사건. 가상의 인물은 아이디어를 따라가기 쉽게 만듭니다. 실제 사건은 시청자가 그것을 믿고 기억하게 만듭니다. 역사가 있는 주제(시장, 기술, 기관)의 경우 최소 두 가지를 조사하십시오. 하나가 누군가의 승리를 보여준다면 어떻게 실패할 수 있었는지 조사하고, 누군가가 손실을 본 사례를 찾으십시오. 승리만으로는 잘못된 교훈을 가르칩니다. 자연 메커니즘이나 방법(하늘이 왜 파란지, 매듭을 묶는 방법)의 경우 실제 관찰, 측정 또는 발견으로 충분하거나 없을 수 있습니다. 브리핑에 "없음, 이유는 ..."이라고 작성하십시오.
  • 요청자가 기억하는 내용, 확인됨. 그것은 단서이며 종종 부분적으로 틀립니다. 각 부분을 확인하고, 유효한 부분을 사용하며, 무엇을 수정했는지와 그 이유를 요청자에게 알리십시오. "요청자가 그렇게 말했기 때문에" 주장을 절대 반복하지 말고, 조용히 삭제하지 마십시오.

자세한 내용: references/research.md.

3단계: 마인드 맵

mindmap.json은 비디오에 포함될 수 있는 모든 아이디어의 짧은 트리입니다(노드 종류는 references/planning.md 섹션 1에 나열되어 있습니다. node tools/mindmap.mjs는 잘못된 것을 알려줍니다). 각 노드는 아이디어가 무엇인지, 세부 사항이 연구의 어디에 있는지("file.md#Heading"), 시청자가 먼저 알아야 할 아이디어, 그리고 연결되는 다른 아이디어를 몇 단어로 말합니다. 각 아이디어는 core(비디오에 포함: 약속에 필요함, 실제 이야기를 말하는 데 필수적, 또는 공정성을 위해 필요), support(조사되고 참이지만 핵심에서 제외: 설명 자료, 요청 시 더 긴 버전, 또는 다음 비디오용), 또는 cut(확인되지 않음, 공정하게 말할 수 없음, 또는 주요 주제와 관련 없음. 예제 테스트에 실패한 실제 이야기는 cut)입니다. 도구는 모든 포인터가 어딘가로 연결되고, 필요한 것이 먼저 가르쳐지지 않는지 확인합니다. 자세한 내용: references/planning.md.

4단계: 스토리보드

비트당 한 행의 표: 시청자가 보는 것, 음성이 말하는 요지, 이를 그리는 컴포넌트, 새로운 단어가 등장하는지 여부, 음성 외에 들리는 것(음악, 효과음)입니다. 각 행은 스크립트의 한 "박자"입니다. 자세한 내용: references/planning.md, references/components.md.

5단계: 스크립트

스크립트는 videos/<id>.mjs 파일입니다. "컴포넌트"를 사용하는 JavaScript 함수: voice(), picture(), caption(), chapter() 등. 각 컴포넌트는 references/components.md에 문서화되어 있습니다. references/authoring-kit.md는 타임라인, 오버레이, 전환을 설명합니다.

node tools/check.mjs <id>로 스크립트를 검증하십시오. 도구는 오타, 분리된 요소, 사용되지 않은 자산을 포착합니다. 각 경고를 읽고 해결하십시오.

6단계: 정확성 검토

스크립트의 모든 주장에 출처가 있는지 확인하십시오. 각 실제 이야기에 대해, 다른 에이전트(또는 두 번째 에이전트가 없는 경우 직접)가 스크립트, 노트 및 소스를 비교하십시오. 수정 사항을 노트에 기록하십시오.

7단계: 이해도 검토

"내가 배운 것" 일기를 작성하십시오. 약속에 도달하는 데 공백이 없는지 확인하십시오. 시청자가 길을 잃을 수 있는 지점을 식별하고 수정하거나 그 이유를 설명하십시오.

8단계: 시각적 검토

모든 스틸 이미지를 살펴보십시오. 잘리거나, 가려지거나, 비어 있거나, 읽을 수 없는 것이 없는지 확인하십시오.

9단계: 음성 및 사운드

음성을 녹음하십시오(out/tts/). 이제 타이밍이 실제 음성을 따릅니다. 이벤트 사운드(효과음)를 설정하십시오. 음악이 있다면 스토리 부분 아래에만 위치하도록 하십시오.

10단계: 내보내기 및 최종 시청

비디오를 mp4로 내보내고, 자막(SRT, VTT), 챕터를 포함하십시오. 내보낸 파일 자체의 프레임을 살펴보고 사운드를 확인하십시오.

11단계: 다른 언어 및 형태(요청 시)

각 언어에 대해 videos/i18n/<id>.<lang>.json 파일을 만드십시오. 각 언어가 check를 통과하고 해당 스틸 이미지를 살펴보았는지 확인하십시오.

12단계: 게시 키트

제목, 설명, 챕터, 자막, 썸네일, 출처 및 크레딧을 포함한 publish.md를 준비하십시오.

13단계: 전달

요청자에게 메시지를 보내십시오. 요청자의 관점에서 비디오를 다시 확인하십시오. 결정된 사항, 수정된 사항 및 아직 열려 있는 사항을 설명하십시오.

전체 작성 규칙, 시각 디자인, 문제 해결 등에 대한 자세한 내용은 references/ 폴더를 참조하십시오.

참고 문서

  • references/research.md: 조사 방법
  • references/planning.md: 마인드 맵 및 스토리보드
  • references/authoring-kit.md: 스크립트 작성 키트
  • references/components.md: 사용 가능한 컴포넌트
  • references/script-review.md: 스크립트 검토 방법
  • references/visual-review.md: 시각적 검토
  • references/voice-and-assets.md: 음성 및 자산
  • references/export-and-publish.md: 내보내기 및 게시
  • references/localization.md: 현지화
  • references/finishing-and-revising.md: 완료 및 수정
  • references/writing-for-everyone.md: 누구나 이해할 수 있는 글쓰기
  • references/teaching-techniques.md: 교육 기법
  • references/visual-design.md: 시각 디자인
  • references/troubleshooting.md: 문제 해결

관련 스킬