Communitygithub.com

CrissAlvarezH/video-script

시청자를 사로잡는 짧은 형식의 비디오 대본을 작성합니다. 제작자의 자체 비디오 분석 데이터를 활용합니다. 선택한 아이디어의 훅(hook)을 결정하거나, 촬영 전 대본을 작성하거나 다듬을 때, 또는 게시된 비디오의 인사이트를 교훈으로 전환할 때 사용합니다. 아이디어 도출은 content-ideas' 역할입니다.

video-script란 무엇인가요?

이 스킬은 짧은 형식의 소셜 미디어 비디오 대본을 작성하는 과정을 데이터 중심으로 안내합니다. 제작자의 과거 비디오 성과 데이터를 최우선으로 활용하여 시청자를 붙잡는 훅, 두 번째 문장, 그리고 증거(proof)를 구성하는 방법에 초점을 맞춥니다. 주요 기능은 크게 두 가지로, 촬영 전 '대본 작성(Script)'과 게시된 비디오의 성과를 분석하는 '리뷰(Review)'입니다. 대본 작성 시에는 시청자가 떠날 이유를 주지 않으면서 호기심을 유지하도록 질문을 열고 닫는 균형을 강조하며, 모든 주장은 화면을 통해 시각적으로 증명되어야 합니다. 또한 이 스킬은 Cursor, Claude Code, Codex와 같은 다양한 AI 코딩 에이전트와의 통합을 염두에 두고 설계되어, 제작자의 음성 라이브러리, 분석 파일, 플랫폼 노트 등이 포함된 프로필을 읽어 개인화된 피드백을 제공합니다. 결과물로는 타임라인, 대사, 화면 설명이 포함된 대본과 함께 검증이 필요한 주장 목록, 대체 훅, 예상 런타임 등을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CrissAlvarezH/ai-reel-gen-app/tree/HEAD/.claude/skills/video-script

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

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

문서

비디오 대본

짧은 비디오의 성패는 촬영 전 세 가지 선택에 의해 크게 결정됩니다: 이해관계(stake)(내부자가 아닌 사람이 관심을 가질 이유), 처음 두 문장(계속 봐야 하는 이유), 그리고 증거(주장을 현실로 만드는 시청자가 보는 것). 각 선택은 증거를 바탕으로 이루어져야 합니다: 제작자의 과거 비디오 데이터를 최우선으로, 다음으로 플랫폼 공식 자료, 마지막으로 직관을 사용합니다.

시청자가 찾는 것은 질문에 대한 답입니다. 호기심이 시청자를 붙잡고, 각 답변은 그들이 떠날 이유를 제공하므로, 대본은 이 둘 사이의 균형입니다: 질문을 일찍 열고, 다른 질문이 열릴 때까지 그 질문을 닫지 마십시오.

설정

SKILL_DIR은 이 스킬의 폴더를 의미합니다. ~/.video-script/profile.md가 존재하면 읽으십시오: 여기에는 제작자의 비디오 라이브러리, 분석 결과 파일, 플랫폼 노트, 음성 및 속도가 명시되어 있습니다. 무엇을 제안하기 전에 분석 결과 파일(아직 진행 중인 테스트 포함)과 라이브러리 인덱스를 읽고, 아이디어와 유사한 과거 비디오를 인용하십시오. 분석 결과가 아래의 기본값과 충돌하는 경우 분석 결과를 우선시하십시오: 이는 이 특정 시청자층을 대상으로 측정된 결과입니다.

프로필이 없으면 플랫폼, 시청자층, 그리고 성과가 좋았던 과거 비디오 하나와 그렇지 않았던 비디오 하나(수치 포함)를 한 번 물어보십시오. 그런 다음 프로필과 라이브러리 형식에 따른 라이브러리를 생성하겠다고 제안하십시오.

목표는 비디오가 만들어지는 목적을 의미합니다: 도달(비구독자로부터의 조회수), 팔로우, 저장 또는 공유. 요청에 목표가 명시되지 않은 경우 도달을 목표로 가정하고 그렇게 명시하십시오.

여기서의 작업은 대본 작성과 게시된 비디오의 리뷰입니다. 아이디어는 content-ideas로 이동합니다. 이 스킬은 대본이나 교훈에서 끝납니다: 촬영은 제작자의 몫이고, 편집은 video-edit의, 애니메이션은 animated-video의 몫입니다.

아이디어

아이디어를 구상하고 저장하는 것은 content-ideas의 역할입니다. 대본이 아이디어에서 시작될 때, 해당 아이디어의 노트에는 이미 훅, 열리는 질문, 숨겨진 내용 및 증거가 명시되어 있습니다: 이를 시작점으로 삼고, 의존하기 전에 출처와 대조하여 확인하십시오.

대본 작성

아이디어를 목표와 함께 한 문장으로 진술하십시오. 두 문장이 필요한 아이디어는 두 개의 비디오입니다; 어느 것을 먼저 만들지 물어보십시오.

훅보다 먼저 보상(payoff)과 가장 강력한 증거를 찾은 다음, 훅을 두 부분으로 작성하십시오: 첫째, 이 시청자가 원하는 결과로 표현된 주제를 그들의 언어와 그들의 문제에 대해 진술하고, 둘째, 당신이 가진 가장 놀라운 사실이나 증거를 제시하여 시청자가 말로 표현할 수 있는 질문을 여십시오. 그 질문에 답할 수 있다면 주제를 명명하지 마십시오. 제작자의 속도(프로필에서 가져오며, 기본값은 초당 3단어)로 초안을 작성하십시오. 세 가지 순간은 시간에 고정되어 있으며, 그 사이의 구간은 하나의 규칙을 따릅니다; 나머지는 이야기 자체의 형태를 따릅니다:

  • 0~3초, 훅: 시청자의 이해관계나 화면에 보이는 것에 관한 내용입니다. 자격 증명(credentials)은 나중에 믿을 이유로 제시됩니다; 시청자가 원하는 결과는 질문을 열 때 이해관계로 간주됩니다.
  • 3~10초, 두 번째 문장: 훅의 이해관계를 높이거나 질문을 더 선명하게 만들되, 답하지는 마십시오. 대부분의 피할 수 있는 이탈이 여기서 발생하므로 배경 설명은 나중으로 미룹니다. 배경이란 시청자가 나중에 나오는 세부 사항(역사, 누군지, 작동 방식 등)을 이해하는 데만 필요한 모든 것입니다; 테스트 방법: 어떤 줄을 15초 이후로 옮겨도 처음 15초에 아무런 손실이 없다면 그것은 배경입니다.
  • 그 사이, 답은 숨겨진다: 보상은 한 순간이 아닙니다. 훅의 질문을 닫는 지점(종종 시청자가 인식하는 용어)을 명명하십시오: 시청자가 그 용어를 듣는 순간 나머지를 안다고 생각합니다. 그 전에는 그곳으로 이끌면서도 그 자체로 들을 가치가 있는 내용이 옵니다: 대부분의 사람들이 틀리는 점, 그로 인한 비용, 명백한 대안이 실패하는 이유 등입니다. 그것이 마침내 언급될 때, 같은 숨결로 새로운 질문, 즉 그들이 들어보지 못한 그에 관한 무언가가 열립니다. 숨긴다는 것은 그동안 다른 무언가를 제공하는 것을 의미합니다; 단순히 기대를 유발하거나 "끝까지 봐주세요"라고 말하는 것은 숨기는 것이 아니라, 채우기(filler)입니다.
  • 끝: 최종 보상, 훅의 약속이 화면에 표시되고, 그 다음에 최대 하나의 짧은 행동 촉구(CTA)가 옵니다. 보상 이후의 모든 것은 떠나는 시청자를 대상으로 합니다.

설명(explainer)(작동 방식)의 경우 초안을 작성하기 전에 설명 가이드를 읽으십시오.

모든 줄 옆에 시청자가 보는 것과 필요한 캡처(화면 녹화, 문서, 실제 인물 또는 제품)를 적으십시오. 아무도 그릴 수 없는 줄은 시청자가 머릿속에 기억해야 하는 줄입니다. 애니메이션 비디오의 경우 이 열은 animated-video에 대한 메모이며, 이는 세계를 디자인합니다.

전달한 후 프로필에 지정된 위치에 저장하십시오: 시간, 음성 대사 및 화면 이미지가 포함된 대본; 캡처 목록; 음성 대본이 할 수 없는 주의 사항과 링크를 담고 있으며, 훅의 질문에 답하기보다는 여는 방식으로 시작하는 초안 캡션; 예상 런타임; 대체 훅(각각 고유한 두 번째 문장 포함, 오프닝이 여전히 열려 있는 경우); 그리고 출처와 함께 확인해야 할 주장 목록(열 수 없었던 출처는 표시). 새로운 에이전트가 대본에 나온 각 주장을 출처와 비교하여 확인하도록 하십시오: 올바른 연구라도 대본에서 과장될 수 있습니다.

제작자가 일부 줄을 다시 작성하는 경우, 귀하가 여전히 소유한 줄에 스타일 차이를 반영하십시오. 편집을 요청하지 않는 한 제작자의 표현을 유지하고, 그 안에서 사실적 문제를 별도로 제기하십시오.

체크리스트

대본을 전달하기 전에 다음 사항과 분석 결과 파일 및 플랫폼 노트에 대해 대본을 점검하십시오:

  • 하나의 아이디어. 목록은 모든 항목이 그 아이디어를 증명할 때만 자격이 있습니다.
  • 이해관계는 영향을 받는 사람과 그들이 원하는 것을 기준으로, 비전문가도 아는 용어로 구성됩니다. 도구 이름과 전문 용어는 시청자가 관심을 가질 이유가 생긴 후에 등장합니다.
  • 시청자로서 읽으십시오: 각 줄에서, 지금 답을 알 것 같아서 떠날 것 같은지 스스로에게 물어보십시오. 계획된 시점보다 먼저 그런 느낌이 든다면, 그 줄을 이동하거나 그 자리에서 다음 질문을 여십시오. 훅의 질문을 닫는 지점과 그 시점을 명시하십시오.
  • 모든 주장이 시각적으로 입증됩니다. 음성, 자막, 화면이 동일한 수치를 제공합니다.
  • 훅의 모든 약속이 화면에서 보상됩니다.
  • 각 문장은 그 자체로 읽었을 때 누가 무엇을 누구에게 하는지, 결과가 어디로 가는지 명확히 말합니다. 생략된 목적어와 모호한 지시 대상을 명사로 대체하고, 지시 대상이 명확한 대명사는 유지하십시오. 수정(revisions)은 이를 깨뜨리므로, 각 수정 후 다시 확인하십시오.
  • 줄은 제작자의 목소리(프로필이 지정하는 음성 가이드)로 된 완전하고 연결된 문장이며, 소리 내어 말하기 쉽습니다. 너무 짧게 잘려 질문을 제기하는 줄("전체 경로"가 무엇의?)은 절약한 초보다 더 큰 비용이 듭니다.
  • 각 줄은 이야기를 앞으로 이끕니다(이전 줄을 반복하거나 앞으로 올 내용을 알리는 줄은 그렇지 않음), 런타임은 이야기가 허용하는 한 짧습니다.

게시된 비디오 리뷰

  • 모든 수치를 기록하십시오: 조회수, 시청자 수, 평균 시청 시간, 팔로우, 상호작용 수, 각 비율과 레이블, 소스별 조회수, 그리고 기간이 포함된 유지율 곡선(인사이트 읽기 참조). 스크린샷에서 python3 SKILL_DIR/scripts/retention_curve.py SHOT --duration SECONDS를 사용하여 곡선을 읽고 영역 기반 평균을 앱의 수치와 비교하십시오. 각 스크린샷의 비디오를 썸네일, 그래프 날짜 및 조회수로 식별하십시오; 증거만으로 판단할 수 없는 경우 질문하십시오.
  • 곡선을 최종 렌더링의 자막과 일치시키십시오: 모든 급락(cliff)과 고원(plateau)에 대해 그 이전 몇 초 동안 말해진 내용과 보여진 내용을 기록하십시오. 라이브러리의 동일한 형식의 비디오와 모든 비디오의 3→10초 드롭과 비교하십시오.
  • 만들 가치가 있는 다음 버전이 있을 경우 명명하십시오: 발견한 문제를 해결하는 가장 작은 변경(예: 새로운 훅, 사람들이 떠난 지점의 컷) 또는 다른 비디오를 능가한 비디오가 다르게 한 것이 무엇이며 이를 어떻게 반복할지.
  • 비디오의 라이브러리 항목과 인덱스 행을 작성한 다음 분석 결과 파일을 업데이트하십시오: 각 가설에 해당 증거를 추가하고, 두 개 이상의 비디오가 일치할 때만 상태를 변경하십시오. 저장하기 전에 모든 인용된 줄과 시간은 요약이 아닌 자막 파일에서 가져오고, 게시 날짜는 출처와 함께만 제공하며, 모든 순위 단어(가장 높은, 가장 낮은, 유일한, 최고의)는 인덱스를 기준으로 해당 비디오 범위 내에서 확인하십시오.

Individual skills in this repo

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

CrissAlvarezH/animated-video

Make animated videos in code with Remotion (React, SVG, three.js): explainers, character stories, motion graphics, kinetic typography, paper collage and animated infographics, in 2D or 3D, from a script or voiceover, in any aspect ratio. Use when asked to animate a script, make an animated video or Reel, or motion graphics. Not for editing camera footage (video-edit) or AI-generated clips (higgsfield-*).

CrissAlvarezH/new-style

Create a new visual style for the creator's videos in a Reel Studio workspace (styles/<id>/style.json): interview him for its name, feel, colours and what each one means, fonts, motion, where pictures come from, reference links and images, then write the style so it shows in Estilos and new videos can use it. Use when he asks for a new style or presses "Nuevo estilo" on the Estilos page.

CrissAlvarezH/persona-hablando

The "Persona hablando + animaciones" format of a Reel Studio video — the creator talks to camera in his own recording; you transcribe it, agree the cuts with him (pauses, flubs, retakes), cut it, and lay the video's style animations over or between his shots. Use for any video whose format.txt says persona-hablando.

CrissAlvarezH/reel-studio

How a narrated explainer video is made in a Reel Studio workspace, in any visual style — script, pictures, voice, images, build, board, sound, mute test, render — following the creator's settings from the studio (profile, format, voice, image sources). Use for any new or revised video in a project's videos/ (projects/<id>/videos/). The video's style adds its own skill (styles/<id>/SKILL.md) for the look and the Remotion kit; LESSONS.md has what past videos taught.

관련 스킬