Communitygithub.com

내레이션 스크립트

튜토리얼이나 데모를 위한 음성 내레이션을 작성합니다. 실제 말로, 귀에 들리도록 구사하며 화면의 동작과 동기화하고, 템포 예산을 고려하며 자신감 있고 전문 용어를 점검한 어조를 사용합니다.

내레이션 스크립트란 무엇인가요?

이 기술은 튜토리얼 또는 데모 비디오의 음성 내레이션 스크립트를 작성하는 데 특화되어 있습니다. 핵심은 시청자가 화면을 보면서 동시에 듣는 상황에서 주의를 분산시키지 않도록 '적게 말하고, 더 명확하게 전달하며, 각 문장을 눈에 보이는 동작에 정확히 연결'하는 것입니다. 내레이션은 '한 번에 하나의 지시' 원칙을 따라야 하며, 화면의 동작과 정확히 동시에 또는 약간 먼저 말해야 과거를 설명하는 데드 에어(dead air)를 방지할 수 있습니다. 또한 분당 140~160단어의 템포를 유지하고, 각 단계를 '목표-행동-확인'의 세 부분으로 구조화하여 시청자가 길을 잃지 않도록 안내합니다. 어조는 '유능한 동료가 옆에서 알려주는' 것처럼 자신감 있고 따뜻하되, 'basically'나 'simply' 같은 경멸적인 단어를 배제하며 UI 레이블을 정확히 일치시키는 것이 중요합니다. 출력 형식은 '화면 동작'과 '음성 대사'의 두 열로 된 표를 제공하며, 필요시 [pause]와 볼드체 강조를 포함합니다. 이 기술은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, SKILL.md 문서를 기반으로 구현됩니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/SkillMedev/tutorial-video-studio/tree/main/skills/narration-script

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

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

문서

내레이션 스크립트은(는) 무엇을 하나요?

튜토리얼의 성패는 내레이션에 달려 있습니다. 시청자는 듣는 동시에 화면의 작업을 수행하려고 하므로, 모든 단어가 시청자의 주의를 화면과 나누게 됩니다. 적게 쓰고, 더 명확하게 말하며, 각 대사를 눈에 보이는 동작에 고정하세요.

귀를 위해 쓰고, 페이지를 위해 쓰지 마세요

구어는 문어가 아닙니다. 문장을 유지하기 전에 항상 소리 내어 읽어보세요.

  • 짧은 문장. 각 문장에 하나의 아이디어. 숨이 차면 너무 긴 것입니다.
  • 능동태, 현재 시제, 2인칭: "저장을 클릭하세요" - "사용자가 저장 버튼을 클릭할 것입니다"가 아닙니다.
  • "basically", "simply", "just"를 모두 잘라내세요. "그냥 설정을 클릭하세요"는 막힌 시청자에게 조용히 당신이 멍청하다고 말하는 것입니다. 없애세요.
  • 축약형은 좋습니다("당신은", "그것은"); 인간적으로 들립니다.

내레이션을 동작에 동기화하세요

핵심 규칙: 화면 동작당 하나의 지시, 그리고 단어는 동작과 함께 도달해야 하며, 이미 일어난 일을 절대 설명하지 않습니다.

  • 시청자의 손과 커서가 함께 움직일 수 있도록 동작이 화면에 나타나기 한 박자 전 또는 정확히 동시에 지시를 말하세요.
  • 이미 끝난 클릭을 절대 내레이션하지 마세요 - 저장 애니메이션 후에 "이제 저장했습니다"는 데드 에어입니다.
  • 화면이 복잡한 작업을 수행할 때는 말을 멈추고 숨을 쉬게 하세요. 명확한 시각적 요소 위의 침묵이 그것과 싸우는 내레이션보다 낫습니다.

템포를 조절하세요

  • 지시의 경우 분당 약 140~160단어를 목표로 하세요. 더 빠르면 따라하는 사람들이 놓칩니다.
  • 스토리보드의 장면별 시간에 맞춰 스크립트 예산을 세우세요. 한 장면이 8초라면 약 20단어이지 50단어가 아닙니다.
  • 전환 시점과 시청자가 듣기보다 봐야 하는 순간에 의도적으로 멈춤을 넣으세요.

각 단계를 구조화하세요

단계당 신뢰할 수 있는 세 부분 구조는 시청자의 방향을 유지합니다:

  1. 목표 - 우리가 하려는 것과 그 이유 ("이것을 공유하려면 공개 링크를 만들겠습니다.")
  2. 행동 - 단일 구체적 지시 ("공유 메뉴를 열고 링크 있는 모든 사람을 선택하세요.")
  3. 확인 - 성공한 모습 ("링크가 준비되면 초록색으로 변하는 것을 볼 수 있습니다.")

단계 사이를 가벼운 전환으로 표시하세요 - "다음", "이제 링크가 있으니 ..." - 그래서 튜토리얼의 뼈대가 항상 들리도록 하세요.

어조

자신감 있고 따뜻하게, 마치 유능한 동료가 옆에 앉아 있는 것처럼. 절대 거만하지도, 과장되지도 않게. 용어가 처음 등장할 때 정의하고, 이후에는 일관되게 사용하세요. 화면의 UI 레이블과 정확히 일치시키세요 - 버튼이 "새 프로젝트"라면 "새 프로젝트"라고 말하고 "프로젝트 만들기"라고 말하지 마세요.

출력 형식

편집자와 VO 인재 모두가 따를 수 있는 두 열의 스크립트를 제공하세요:

화면 동작음성 대사
커서가 공유 메뉴를 엽니다"오른쪽 상단의 공유 메뉴를 여세요."
링크가 공개로 전환됩니다"링크 있는 모든 사람으로 전환하세요."

시각적 요소가 순간을 전달해야 하는 곳에는 [pause]를 표시하고, 강조할 단어는 볼드체로 표시하세요. 스토리보드 시간이 알려진 경우 대사당 대략적인 시간을 기록하세요.

하지 말아야 할 것

  • 음악, SFX 또는 믹스 큐를 여기에 작성하지 마세요 - 오디오 템포, 덕킹 및 비트 매칭은 사운드 및 음악 동기화 영역입니다.
  • 장면 순서나 촬영 목록을 계획하지 마세요 - 이는 비디오 스토리보드이며, 이 스크립트는 이를 따라야 합니다.
  • 시청자가 이미 볼 수 있는 내용을 설명하지 마세요 ("여기 화면이 있고, 몇 개의 버튼이 보입니다.")
  • 대사가 해당 장면의 시간 예산을 초과하지 않도록 하세요; 단어를 줄이고 멈춤은 유지하세요.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

Captions From Transcript

Produce an accurate, properly timed caption track (SRT or WebVTT) from a video

Kinetic Typography

Put text in motion the right way - title cards, animated captions, lower-thirds, callouts, and word-by-word reveals - with a reading-time-per-word budget so copy holds long enough to read, plus enter/exit timing, weight and size transitions, and type hierarchy in motion. Use when someone asks to

Motion Design Principles

The craft layer for motion: pick the right easing (ease-in / ease-out / ease-in-out / spring), get timing and spacing right, build the anticipation→action→follow-through arc, and apply Disney

Product Demo Director

Direct the craft of putting a real software UI on screen - cursor choreography, zoom/pan/callout language, screen-recording vs recreated-UI, and making state changes legible with highlights, focus pulls, and slow-downs. Use when filming or recreating an app for a product demo, feature walkthrough, onboarding clip, or release reel and asking

Remotion Compose

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says

Remotion Render

Renders a Remotion composition to MP4 and runs the edit-and-re-render loop - CLI render commands, 1080p/4K/9:16 presets, concurrency tuning, codec selection, batch variants from a JSON data file, and Lambda for cloud rendering. Use when someone says

Remotion Setup

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just

Screencast Capture

Capture clean raw screen and camera footage for a tutorial or product demo - choosing the recorder (macOS Screenshot toolbar, QuickTime, OBS, Windows Game Bar), setting resolution / frame-rate / cursor / microphone, prepping a distraction-free stage, and recording in retakeable segments. Use when someone says

SkillMedev/tutorial-video-studio

Plan a product demo, feature announcement, or launch video as a beat sheet and shot list BEFORE animating - hook in the first 3s, problem, reveal, proof, CTA - with target duration and pacing per scene type, output as a JSON scene plan that remotion-compose consumes directly. Use when someone says

Social Video Formatter

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says

Sound and Music Sync

Score a video like an editor: beat-match cuts to the music, land SFX on transitions, pace the voiceover so it breathes, source royalty-free tracks safely, and duck the music so the VO sits clearly on top. Use when adding music, sound effects, or voiceover to a video, when asked to

관련 스킬