Communitygithub.com

비디오 스크립트 작성기

사용자가 제품 데모, 기능 소개, 출시 비디오 또는 기능/제품 변경에 관한 소셜 미디어 비디오 스크립트를 작성하려 할 때 사용합니다.

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

이 스킬은 제품 데모, 기능 소개, 출시, 소셜 미디어용 비디오 스크립트를 작성하는 AI 에이전트 도구입니다. 마케팅 브리프, 블로그 포스트, 체인지로그, PR, Git 참조 범위, 코드베이스 파일, 자유 형식 텍스트 등 다양한 입력 소스를 자동으로 분석하여 스크립트의 기반을 마련합니다. 6단계 프로세스(입력 분석, 설정, 개요, 작성, 검토, 출력)를 통해 사용자와 협업하며, 비디오 길이(숏폼/미디엄폼), 스크립트 유형(내레이션/2열/토킹헤드), 톤, CTA를 구성 가능합니다. 마지막으로 최종 승인된 스크립트를 터미널에 출력하고 파일로 저장할 수 있습니다. 주로 Claude Code, Cursor 등 AI 기반 개발 환경에서 사용됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/video-script

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

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

문서

비디오 스크립트 작성기은(는) 무엇을 하나요?

제품 데모, 기능 소개, 출시 비디오를 위한 비디오 스크립트를 작성합니다. 페이싱, 비주얼 방향, 타이밍, 플랫폼에 적합한 길이를 처리합니다.

입력 결정

제공된 인수를 다음 순서대로 확인합니다:

  1. 기존 마케팅 브리프(.md, "Executive Summary" 또는 "Key Messages" 포함) 경로 -> 마케팅 브리프
  2. 기존 블로그 포스트(.md, 블로그 포스트 구조) 경로 -> 블로그 포스트
  3. 기존 체인지로그 경로 -> 체인지로그
  4. 기존 뉴스레터 경로 -> 뉴스레터
  5. GitHub URL 또는 #\d+ 패턴 일치 -> PR
  6. ... 또는 .. 포함 -> Git 참조 범위
  7. 기존 파일/디렉토리로 확인됨 -> 코드베이스 기능
  8. 그 외 -> 자유 형식 텍스트

인수가 제공되지 않으면 "비디오의 주제는 무엇인가요? 마케팅 브리프, 블로그 포스트, 체인지로그, PR URL/번호, Git 참조 범위, 파일/디렉토리 경로를 제공하거나 기능을 설명해 주세요."라고 묻습니다.

여러 해석이 일치하면 사용자에게 확인합니다.

프로세스 흐름

digraph video_script {
    rankdir=TB;
    "입력 결정" [shape=box];
    "단계 1: 분석" [shape=box];
    "단계 2: 구성" [shape=box];
    "단계 3: 개요" [shape=box];
    "개요 승인?" [shape=diamond];
    "단계 4: 작성" [shape=box];
    "단계 5: 검토" [shape=box];
    "승인?" [shape=diamond];
    "단계 6: 출력" [shape=box];

    "입력 결정" -> "단계 1: 분석";
    "단계 1: 분석" -> "단계 2: 구성";
    "단계 2: 구성" -> "단계 3: 개요";
    "단계 3: 개요" -> "개요 승인?";
    "개요 승인?" -> "단계 3: 개요" [label="아니오, 수정"];
    "개요 승인?" -> "단계 4: 작성" [label="예"];
    "단계 4: 작성" -> "단계 5: 검토";
    "단계 5: 검토" -> "승인?";
    "승인?" -> "단계 4: 작성" [label="수정 필요"];
    "승인?" -> "단계 6: 출력" [label="예"];
}

단계를 건너뛰지 마십시오. 질문은 자연스러운 속도로 해 주세요. 사용자가 한 번에 여러 질문에 답하면 묶어서 처리하고 앞으로 건너뜁니다.

사용자가 "기본값으로 해 줘" 또는 비슷한 말을 하면 적절한 기본값을 선택하고, 선택한 내용을 알린 후 한 번의 확인을 요청합니다.

단계 1: 분석

1단계 - 입력 분석

입력 유형읽을 내용
마케팅 브리프문제 설명, 가치 제안, 대상, 핵심 메시지 추출. 3단계로 건너뜁니다. 브리프에 제품 맥락이 없으면 2단계는 여전히 수행합니다.
블로그 포스트제목, 핵심 포인트, 대상, CTA 추출. 3단계로 건너뜁니다.
체인지로그주요 항목 추출, 가장 영향력 있는 변경 사항에 집중. 3단계로 건너뜁니다.
뉴스레터제목, 주요 업데이트, CTA 추출. 3단계로 건너뜁니다.
PRdiff, PR 설명, 리뷰 코멘트, 커밋 메시지. 대규모 PR(20개 이상 파일)은 사용자 대상 변경 사항에 집중합니다.
Git 참조 범위참조 간 git diff 및 git log. 사용자 대상 변경 사항을 우선시합니다.
코드베이스 기능지정된 파일/디렉토리를 읽습니다.
자유 형식 텍스트사용자의 설명을 분석합니다. 구체적인 내용이 부족하면 사용자에게 자세한 내용을 제공하거나 특정 파일/PR을 가리키도록 요청합니다.

사용자 대상 변경 사항에는 다음이 포함됩니다: 새로운 기능, UI 변경, API 변경, 성능 개선, 버그 수정, 문서 업데이트. 내부 변경 사항에는 다음이 포함됩니다: 리팩토링, 테스트 추가, CI 변경, 종속성 업그레이드.

오류 처리:

  • gh를 사용할 수 없음 -> 사용자에게 알리고 대체 입력 제공
  • 잘못된 PR/참조 -> 사용자에게 확인 요청
  • 파일을 찾을 수 없음 -> 올바른 경로 요청

2단계 - 더 넓은 제품 맥락 읽기

존재하는 경우 읽기: README, docs/, package.json(또는 동등 파일).

아무것도 없으면 "제품과 대상이 누구인지 간단히 설명해 주시겠어요?"라고 묻습니다.

3단계 - 이해 내용 제시

"비디오 스크립트의 기반으로 사용할 내용은 다음과 같습니다:"

  • 기능 A - 간단한 설명
  • 기능 B - 간단한 설명

"추가, 삭제 또는 수정할 내용이 있나요?"

사용자가 범위를 확인할 때까지 진행하지 마십시오.

4단계 - 민감한 내용 확인

진행하기 전에 보안 패치, 내부 가격, 자격 증명, 미공개 로드맵 항목 또는 기밀 표시 콘텐츠와 같은 잠재적으로 민감한 내용을 스캔합니다. 의심스러운 내용이 있으면 사용자에게 알립니다.

단계 2: 구성

다음 질문을 합니다:

Q1 - 비디오 길이:

  • 숏폼(30-90초) - 소셜 미디어(릴스, 쇼츠, 틱톡)
  • 미디엄폼(3-5분) - 유튜브, 제품 데모, 소개

Q2 - 스크립트 유형:

  • 내레이션 - 화면 녹화/영상 위에 읽을 나레이션 텍스트
  • 2열 - 왼쪽 열: 비주얼 방향/화면 동작, 오른쪽 열: 나레이션
  • 토킹헤드 - 카메라 앞의 발표자, 대화체 전달

Q3 - 톤: 기존 저장소 내용을 읽어 음성을 감지합니다. 확인:

"기존 콘텐츠를 보니 톤이 [예: 대화체로 개발자 친화적]인 것 같습니다. 이와 일치시킬까요, 아니면 다른 방향으로 갈까요?"

분석할 콘텐츠가 없으면 직접 물어봅니다.

Q4 - CTA: 맥락에서 유추:

  • 오픈 소스 -> "리포지토리에 별표를 눌러 주세요", "사용해 보세요"
  • SaaS -> "무료로 가입하세요", "평가판 시작하기"
  • 기능 업데이트 -> "지금 사용해 보세요", "문서 확인하기"

"CTA를 [유추된 CTA]로 제안합니다. 이대로 갈까요, 아니면 다른 것으로 할까요?"

단계 3: 개요

타이밍이 포함된 구조화된 개요를 생성합니다. 비디오 길이에 따라 적절한 템플릿을 사용합니다:

숏폼(30-90초) - 3-4개 섹션:

## [작업 제목] - [총 길이]

1. **후크** (0:00-0:05) - [접근 방식]
   - 핵심 포인트
   - 비주얼: [보여줄 내용]

2. **문제** (0:05-0:15) - [설정할 페인 포인트]
   - 비주얼: [보여줄 내용]

3. **해결책** (0:15-0:45) - [기능 소개]
   - 핵심 포인트 A
   - 비주얼: [보여줄 내용]
   - 핵심 포인트 B
   - 비주얼: [보여줄 내용]

4. **CTA** (0:45-0:60) - [취할 행동]
   - 비주얼: [엔드 화면]

예상 총 단어 수: ~X 단어 (~Y초, 135 WPM 기준)

미디엄폼(3-5분) - 5-8개 섹션:

## [작업 제목] - [총 길이]

1. **후크** (0:00-0:10) - [접근 방식]
   - 비주얼: [보여줄 내용]

2. **문제** (0:10-0:30) - [페인 포인트, 맥락, 왜 중요한지]
   - 비주얼: [보여줄 내용]

3. **해결책 개요** (0:30-1:00) - [구축한 내용의 개괄]
   - 비주얼: [보여줄 내용]

4. **심층 분석: [기능 A]** (1:00-2:00) - [소개]
   - 핵심 포인트
   - 비주얼: [화면 녹화 단계]

5. **심층 분석: [기능 B]** (2:00-3:00) - [소개]
   - 핵심 포인트
   - 비주얼: [화면 녹화 단계]

6. **심층 분석: [기능 C]** (3:00-3:45) - [소개]
   - 핵심 포인트
   - 비주얼: [화면 녹화 단계]

7. **요약** (3:45-4:30) - [핵심 이점 요약]
   - 비주얼: [요약 슬라이드 또는 나란히 보기]

8. **CTA** (4:30-5:00) - [취할 행동]
   - 비주얼: [엔드 화면]

예상 총 단어 수: ~X 단어 (~Y초, 135 WPM 기준)

다루는 기능에 맞춰 심층 분석 세그먼트 수를 조정합니다.

개요를 제시하고 작성 전에 승인을 기다립니다.

단계 4: 작성

페이싱 참조

비디오 길이목표 단어 수WPM
30초~65 단어130
60초~135 단어135
90초~200 단어135
3분~400 단어135
5분~675 단어135

대화체 전달의 경우 130-145 WPM을 목표로 합니다. 할당된 시간을 초과하는 섹션은 플래그를 지정합니다.

유형별 스크립트 형식

내레이션 스크립트:

## [제목]

### 후크 (0:00-0:05) - ~15 단어
비주얼: [화면에 보여줄 내용 설명]

[나레이션 텍스트]

### 섹션 이름 (0:05-0:20) - ~30 단어
비주얼: [화면에 보여줄 내용 설명]

[나레이션 텍스트]

2열 스크립트:

| 시간 | 비주얼 | 나레이션 |
|---|---|---|
| 0:00-0:05 | [화면: 랜딩 페이지 로드] | [나레이션 텍스트] |
| 0:05-0:15 | [화면: 설정 메뉴 클릭] | [나레이션 텍스트] |
| 0:15-0:30 | [화면: 다크 모드 토글] | [나레이션 텍스트] |

토킹헤드 스크립트:

## [제목]

### 후크 (0:00-0:05) - ~15 단어
카메라: [발표자 카메라, 미디엄 샷]

[발표자 텍스트. 대화체, 카메라를 직접 응시.]

### 섹션 이름 (0:05-0:20) - ~30 단어
카메라: [화면 녹화로 전환]
내레이션: [화면 녹화 위의 나레이션]

카메라: [발표자로 돌아옴]
[발표자 텍스트]

후크

처음 3-5초가 시청자가 계속 볼지 결정합니다. 후크는 다음을 충족해야 합니다:

  • 페인 포인트를 언급하거나 도발적인 질문을 던집니다
  • 회사/제품 이름으로 시작하지 않습니다
  • "이 비디오에서는 ...을 보여 드리겠습니다"로 시작하지 않습니다
  • 즉각적인 호기심이나 감정적 공명을 만듭니다

비주얼 방향

스크립트 유형에 관계없이 항상 인라인으로 비주얼 방향을 포함합니다:

  • 화면 녹화 및 영상의 경우 비주얼: / 화면:
  • 토킹헤드 카메라 방향의 경우 카메라:
  • 구체적으로 작성: "화면: 내보내기 버튼 클릭, PDF 다운로드 표시" ("화면: 기능 표시"가 아님)
  • 장면 사이에 전환 노트 포함

섹션별 타이밍

모든 섹션에 예상 길이와 단어 수를 포함합니다:

  • ### 섹션 이름 (0:15-0:30) - ~30 단어
  • 시간 예산을 초과하는 섹션은 플래그를 지정합니다
  • 전체 스크립트 단어 수는 135 WPM에서 목표 길이와 일치해야 합니다

작성 규칙

  • 대화체로, 대본 같지 않게. 사람들이 실제로 말하는 방식으로 작성합니다.
  • 짧은 문장. 문장당 최대 10-15 단어.
  • 문장당 하나의 아이디어.
  • 항상 능동태.
  • 생성된 콘텐츠에 절대 대시를 사용하지 마십시오. "---" 문자는 사용하지 마십시오. 대신 쉼표, 콜론, 마침표 또는 괄호를 사용합니다.
  • 말로 설명하지 말고 보여 주세요. "이게 얼마나 빠르게 로드되는지 보세요" > "매우 빠르게 로드됩니다"
  • 미디엄폼 비디오의 경우 세 가지 법칙을 사용합니다: 세 가지 이점, 세 가지 기능, 세 가지 예시. 숏폼의 경우 단일 핵심 이점에 집중합니다.

CTA

  • 비디오의 마지막 5-10초
  • 단일하고 명확한 행동
  • 엔드 화면(구독 버튼, 링크 오버레이, QR 코드)에 대한 비주얼 방향 포함

단계 5: 검토

타이밍 분석과 함께 완전한 스크립트를 제시합니다:

"스크립트는 다음과 같습니다:"

[전체 스크립트]

타이밍 분석:

  • 후크: 5초 (~15 단어)
  • 문제: 10초 (~25 단어)
  • 해결책: 30초 (~70 단어)
  • CTA: 10초 (~20 단어)
  • 총합: 55초 (~130 단어, 135 WPM)

"변경할 부분이 있나요?"

승인을 기다립니다. 사용자가 확인한 후에만 출력 단계로 진행합니다.

단계 6: 출력

항상 최종 승인된 스크립트를 터미널에 출력합니다.

그런 다음 "이것을 scripts/<슬러그>.md에 저장할까요? 아니면 다른 경로로 할까요?"라고 묻습니다.

디렉토리가 없으면 생성합니다. 파일이 이미 존재하면 덮어쓸지 아니면 버전이 지정된 복사본을 만들지 묻습니다.

오류 처리

  • gh를 사용할 수 없음 -> 사용자에게 알리고 대체 입력 제공
  • 잘못된 PR/참조 -> 사용자에게 확인 요청
  • 제품 맥락 없음 -> 사용자에게 제품 설명 요청
  • 스크립트가 목표 길이 초과 -> 검토 전에 플래그를 지정하고 컷 제안

이 스킬이 하지 않는 일

  • 비디오 녹화 또는 편집
  • 썸네일 또는 비주얼 에셋 생성
  • 애니메이션 또는 모션 그래픽 생성
  • 블로그 포스트 또는 소셜 카피 작성 (/blog-post 또는 /social-copy 사용)

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

관련 스킬