Communitygithub.com

you-decide-story

한 문단의 이야기를 1080x1920 세로형 동영상(MP4)으로 변환합니다. 모든 장면을 인라인 SVG로 그리고 GSAP으로 애니메이션을 적용하며, 내레이터 음성, 자막, 상단 시계 및 마지막에 두 단어 선택지를 포함합니다.

you-decide-story란 무엇인가요?

이 스킬은 사용자가 제공한 하나의 문단을 '당신이 결정하세요' 형식의 세로형 동영상으로 만들어 줍니다. 카메라 촬영이나 이미지 생성 없이 모든 장면을 인라인 SVG 코드로 그리고 GSAP을 사용해 움직임을 추가합니다. 내레이터 음성(맥 기본 음성 또는 일레븐랩스)과 음성에 맞춰진 자막, 상단에 표시되는 시계/카운터, 마지막의 두 단어 선택지가 결합되어 약 20~45초 길이의 숏폼 콘텐츠(릴스, 쇼츠, 틱톡)를 만듭니다. 클로드 코드 환경에서 실행되며 Node.js v22 이상, ffmpeg, GSAP, Playwright가 필요합니다. 스토리 라인 생성부터 음성 녹음, 장면 드로잉, 렌더링까지 9단계로 이루어지며, 각 단계별로 확인 프레임을 검사하여 품질을 보장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zeroedithq/claude-video-skills/tree/HEAD/you-decide-story

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

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

문서

You Decide Story

당신은 세로형 짧은 동영상(1080x1920, 약 20~45초)을 만들어 작은 이야기를 들려주고 선택지에서 멈춥니다. 어떤 것도 촬영하지 않고 이미지도 생성하지 않습니다. 모든 장면을 인라인 SVG로 그리고 GSAP이 움직임을 적용하며 내레이터가 대사를 읽고 스크립트가 프레임을 MP4로 렌더링합니다. 사용자가 한 문단을 제공하면 당신이 렌더링된 동영상을 돌려줍니다.

네 가지 구성 요소

모든 에피소드는 다음 네 가지를 모두 포함합니다.

  1. 첫 3초 안에 말해지는 한 문장의 전제. 2인칭, 현재 시제: "당신은 오늘 밤 마지막 버스를 운전합니다." 패턴은: 당신, 장소, 약간 이상한 세부 사항 하나입니다. 시청자는 스크롤하기 전에 자신이 누구이고 어디에 있는지 알게 됩니다.
  2. 상단 스트립에 계속 표시되며 적어도 한 번 변경되는 시계 또는 카운터. "오후 11:58"이 "오후 11:59"가 됩니다. "성냥 3개"가 "성냥 2개"가 됩니다. 이 변경은 시청자에게 시간이 얼마 남지 않았음을 알려줍니다.
  3. 이야기의 각 줄마다 하나씩 그려지는 장면. 이야기는 5~7줄로 구성됩니다. 각 줄은 고유한 그림과 자막을 가집니다. 그림은 내레이터가 해당 줄을 말하기 시작하는 순간에 바뀝니다.
  4. 마지막의 두 단어 선택지. 화면이 어두워지고 "당신은요?"라고 묻습니다. 그런 다음 두 가지 옵션, 각각 한 단어(예: 대답 / 하지마), 그 다음 "한 단어로 댓글을 남기세요". 이야기는 해결되지 않습니다. 선택이 결말입니다.

파일

SKILL_DIR은 이 파일이 있는 폴더입니다. 명령어에서 실제 절대 경로를 사용하세요. 스킬이 로드될 때 Claude Code가 이를 표시합니다. 그렇지 않으면 프로젝트의 .claude/skills/you-decide-story 또는 ~/.claude/skills/you-decide-story입니다.

SKILL_DIR/scripts/voice.mjs       story.json -> 내레이터 오디오 + timing.json
SKILL_DIR/scripts/render.mjs      에피소드 페이지 -> 확인 프레임 또는 MP4
SKILL_DIR/template/episode.html   모든 에피소드에 대해 복사하는 페이지

하나의 에피소드는 사용자 프로젝트 안의 한 폴더이며, 이야기 이름을 따서 명명됩니다:

last-bus/
  story.json       당신이 작성 (1단계)
  timing.json      voice.mjs가 작성 (2단계). 절대 수동으로 편집하지 마세요.
  audio/           voice.mjs가 작성 (2단계)
  episode.html     템플릿에서 복사 (3단계), 그런 다음 그 안에 그림을 그립니다
  out/check/       확인 프레임 (6단계)
  out/episode.mp4  동영상 (8단계)

첫 번째 에피소드 전에

사용자 프로젝트 폴더에서 다음을 실행하세요:

node --version           # v22 이상이어야 함
ffmpeg -version          # 버전이 출력되어야 함
npm ls gsap playwright   # 둘 다 나열되어야 함

gsap 또는 playwright가 누락된 경우 프로젝트 폴더에 설치하세요: npm install gsap playwright, 그런 다음 npx playwright install chromium. Node.js 또는 ffmpeg가 누락된 경우 중단하고 사용자에게 무엇을 설치해야 하는지 알리세요.

단계

다음 순서대로 단계를 수행하세요. 7단계가 깔끔해지기 전에 전체 동영상을 렌더링하지 마세요.

1단계. story.json 작성

사용자의 문단을 5~7줄과 선택지로 변환하세요. 문단은 네 가지 질문에 답해야 합니다: 당신은 어디에 있는가, 지금 몇 시인가(또는 무엇이 떨어지고 있는가), 누구 또는 무엇이 도착하는가, 마지막의 두 단어는 무엇인가. 하나가 누락된 경우, 그것을 창작하고 최종 보고서에서 그렇게 말하세요. 묻기 위해 멈추지 마세요. 이것이 시리즈의 이후 부분인 경우, 사용자가 어떤 단어가 이겼는지 알려줍니다. 그것으로 시작하세요.

{
  "title": "마지막 버스",
  "lines": [
    { "id": "l1", "say": "당신은 오늘 밤 마지막 버스를 운전합니다.", "caption": "당신은 마지막 버스를 운전합니다.", "clock": "오후 11:58", "pause": 0.8 },
    { "id": "l2", "say": "한 남자가 당신을 손짓합니다. 여기는 정류장이 아닙니다.", "caption": "한 남자가 손짓합니다. 정류장 아님.", "clock": "오후 11:59" }
  ],
  "choice": {
    "question": "당신은요?",
    "a": "멈춰", "aNote": "그를 태우다",
    "b": "가", "bNote": "계속 가다",
    "say": { "question": "당신은요?", "a": "멈춰.", "b": "아니면 가.", "cta": "한 단어로 댓글을 남기세요." }
  }
}
필드설명
title상단 스트립의 레이블. 한두 단어. 대문자로 그려집니다.
lines[].id이야기 순서대로 l1, l2, ... 장면 그룹과 모션 코드가 이러한 id를 사용합니다.
lines[].say내레이터가 말하는 내용. 하나 또는 두 개의 짧은 문장, 4~12단어, 현재 시제.
lines[].caption화면에 쓰이는 내용. 핵심만 남긴 줄, 약 40자 미만.
lines[].clock이 줄이 화면에 표시되는 동안 상단 스트립의 텍스트. 값을 유지하려면 반복하세요. 압박이 커지는 줄에서 적어도 한 번 변경하세요.
lines[].pause선택 사항. 줄 후의 침묵 시간(초), 시간이 필요한 그림용(문 열림, 전화 벨소리). 기본값 0.3.
choice.a, choice.b각각 한 단어, 대문자.
choice.aNote, choice.bNote그 단어가 여기서 의미하는 바를 말하는 두세 개의 소문자 단어.
choice.question기본값 당신은요?.
choice.say카드가 만들어지는 동안 내레이터가 말하는 내용, 네 부분으로 나뉘어 각 단어가 말해질 때 도착하도록 합니다.

줄에 대한 규칙:

  • l1은 전제입니다. 2인칭, 현재 시제, 8단어 이하로 3초 안에 끝나야 합니다.
  • 이미 맞는 경우 사용자의 원래 문장을 유지하세요. 문단이 2인칭, 현재 시제, 8단어 이하의 문장으로 시작한다면 그 문장이 그대로 l1입니다.
  • 한 줄은 하나의 그림입니다. 한 줄에 두 개의 그림이 필요하다면 두 줄로 나누세요.
  • 선택지 전의 마지막 줄은 질문을 열린 상태로 둡니다. 답하지 마세요.
  • 이야기는 독창적입니다. 그리기 규칙을 참조하세요.

2단계. 음성 및 timing.json 만들기

node SKILL_DIR/scripts/voice.mjs last-bus
  • Mac에서는 내장된 say 음성을 사용합니다. 무료입니다. --voice Daniel 및 --rate 172가 기본값입니다. 다른 언어의 이야기를 위해서는 해당 언어의 음성을 전달하세요(say -v '?'로 목록 확인).
  • --provider elevenlabs --voice <voice_id>는 ElevenLabs를 사용합니다. ELEVENLABS_API_KEY가 필요하며 사용자 크레딧이 소모됩니다. 사용자가 요청할 때만 사용하세요.
  • --provider silent는 예상 길이의 무음을 씁니다. 시스템에 음성이 없을 때 사용하세요. 동영상에 내레이션이 없다고 사용자에게 알리세요.

스크립트는 각 줄의 시작 및 종료 시간(초)을 출력하고 audio/voice.wav와 timing.json을 씁니다. 또한 형식을 확인하고 각 문제에 대해 경고: 줄을 출력합니다: 전제가 3초 후에 끝나는 경우, 시계가 변경되지 않는 경우, 선택지가 한 단어보다 긴 경우, 줄이 2초 미만으로 화면에 표시되는 경우. story.json의 모든 경고를 수정하고 스크립트를 다시 실행하세요. say 텍스트를 변경한 후에는 항상 다시 실행하세요.

timing.json은 에피소드의 유일한 시간 기준입니다:

{ "duration": 24.6, "lines": [ { "id": "l1", "start": 0.3, "end": 2.71 }, { "id": "l2", "start": 3.51, "end": 6.4 }, { "id": "choice", "start": 19.2, "end": 19.9 } ] }

3단계. 템플릿 복사

cp SKILL_DIR/template/episode.html last-bus/episode.html

복사본을 한 번 읽으세요. 두 곳을 편집합니다: 장면(SVG)과 motion 함수. 나머지는 엔진입니다. story.json과 timing.json에서 엔진은 이미 장면 전환, 각 장면의 느린 줌, 자막, 시계 및 선택지 카드의 시간을 설정합니다. 이것들을 다시 시간을 설정하지 말고 엔진을 편집하지 마세요.

파일 편집 도구로 복사본을 변경하세요. 에피소드는 하나의 HTML 파일로 유지됩니다: 여러 부분으로 나누지 말고 빌드 스크립트를 작성하지 마세요.

4단계. 장면 그리기

<g id="scenes"> 안에서 두 개의 샘플 장면을 삭제하고 줄당 하나의 그룹을 그리세요:

<g class="scene" id="scene-l2" data-caption-y="1400">
  <!-- 배경 먼저, 그 다음 사물, 그 다음 사람 -->
  <g transform="translate(540 1250) scale(1.12) translate(-540 -1250)">
    <g id="l2-man"> ... </g>
  </g>
</g>
  • 그룹 id는 scene-에 줄 id를 더한 것입니다. 엔진은 해당 줄이 시작될 때부터 다음 줄이 시작될 때까지 이 그룹을 표시합니다.
  • 움직일 모든 부분에 고유한 이름의 그룹을 지정하고, 이름을 줄 id로 시작하세요(l2-man, l2-arm). id는 페이지에서 고유해야 합니다.
  • 크기와 위치는 외부 그룹에 transform으로 지정하세요. 모션은 그 안의 명명된 그룹에 적용됩니다. transform 속성이 있는 요소를 트윈하거나 .scene 그룹을 트윈하거나 변형하지 마세요.
  • 줄은 이전 장면을 유지할 수 있습니다(그룹을 그리지 않음). 단, 모션을 통해 그림이 해당 줄에서 명확하게 변경되는 경우에만 가능합니다: 누군가 떠나거나, 불이 꺼지거나, 전화가 켜지는 경우.

무대는 1080 x 1920입니다. 한 단위는 동영상의 한 픽셀입니다.

y위치 설명
0 ~ 182상단 스트립: 레이블과 시계. 엔진이 그립니다. 뒤쪽 영역을 단순하게 유지하세요.
250 ~ 1250그림. 주요 주제가 여기에 살며 이 영역을 채웁니다.
1290 ~ 1500자막 밴드. 단어 뒤에 하나의 평평한 어두운 색상: 카운터, 바닥, 도로, 벽.
1560 ~ 1920휴대폰의 앱 버튼에 의해 가려집니다. 이야기에 필요한 것은 없습니다.

장면의 data-caption-y는 자막 위치를 이동합니다(기본값 1400, 자막 중간). data-zoom은 느린 줌을 설정합니다(기본값 1.06, 1은 없음).

5단계. 모션 작성

function motion({ tl, show, line })의 본문을 장면의 모션으로 교체하세요.

const l1 = line('l1'), l2 = line('l2');   // { start, end, next } 시간(초), timing.json에서 가져옴

// 프레임 위에서 떨어져서 튕기며 들어옴
show('#l2-bag', l2.start + 1.0);
tl.fromTo('#l2-bag', { y: -1400 }, { y: 0, duration: 0.55, ease: 'bounce.out' }, l2.start + 1.0);
// 오른쪽으로 걸어 나감
tl.to('#l3-man', { x: 900, duration: 1.3, ease: 'power2.in' }, l3.start + 1.4);
// 흔들림: 울리는 전화기가 자신의 중심을 기준으로 약간 회전
tl.to('#l4-phone', { rotation: 3, svgOrigin: '290 1680', duration: 0.06, repeat: 40, yoyo: true, ease: 'none' }, l4.start);
// 맥동: 울리는 고리, 경고등
tl.fromTo('#l4-rings', { opacity: 0 }, { opacity: 1, duration: 0.3, repeat: 7, yoyo: true, ease: 'sine.inOut' }, l4.start + 0.1);
// 전체 장면 동안 지속되는 것
tl.fromTo('#l1-road', { x: 0 }, { x: -520, duration: l1.next, ease: 'none' }, 0);

규칙. 그림을 음성에 맞추는 규칙입니다:

  • 모든 시작 시간은 timing.json에서 가져옵니다. line('<id>').start에 해당 줄 내의 오프셋을 더하여 작성하세요. 0, 첫 번째 프레임만 허용되는 유일한 숫자입니다. 6.4와 같이 수동으로 설정한 시간은 허용되지 않습니다: 음성이 다시 만들어지면 시간이 어긋납니다.
  • line(id).start는 해당 줄의 장면으로 전환되는 시점입니다. .end는 내레이터가 멈추는 시점입니다. .next는 다음 줄이 시작되는 시점입니다. line('choice')는 선택지 카드입니다.
  • 나중에 들어오는 모양은 show(el, start)가 필요합니다. 입장 트윈과 같은 시간에 사용하세요. show(el, start, end)는 start 전과 end 후에 숨깁니다.
  • 트윈만 사용하세요. tl.call, onComplete, Math.random(), 타이머는 사용하지 마세요. 렌더러는 각 프레임으로 점프하므로 트윈된 값만 그려집니다.
  • 회전 및 크기 조정에는 svgOrigin: 'x y'가 필요합니다. 이는 무대 단위로 회전 중심점입니다.
  • 각 장면에 줌 외에도 하나 또는 두 개의 움직이는 요소를 제공하세요: 입장, 제스처, 빛. 아무것도 움직이지 않는 장면은 슬라이드처럼 읽힙니다.

트윈에 시작 시간이 없거나, 선택자가 아무것도 일치하지 않거나, story.json과 timing.json이 더 이상 일치하지 않으면 엔진이 명확한 메시지와 함께 중지됩니다.

6단계. 확인 프레임 렌더링 및 검토

node SKILL_DIR/scripts/render.mjs last-bus --frames auto

이 명령어는 last-bus/out/check/에 PNG 파일을 씁니다: 첫 번째 프레임, 각 컷 직후의 프레임(-cut), 각 줄 중간의 프레임(-mid), 마지막 프레임. 출력되는 모든 참고: 줄을 읽으세요.

읽기 도구로 각 PNG를 한 번에 하나씩, 전체 크기로 여세요. 프레임을 건너뛰지 말고 파일 목록으로 판단하지 마세요. 각 프레임에서 다음을 확인하세요:

  1. 하나의 장면이 화면에 있으며, 해당 줄에 맞는 올바른 장면입니다.
  2. 자막을 한 번에 읽을 수 있습니다. 뒤에 밝거나 복잡한 것이 없습니다.
  3. 줄의 주요 주제가 그림 영역의 적어도 1/3을 채웁니다.
  4. 아직 도착하지 않은 것이 프레임 안에 없습니다. 각 -cut 프레임을 모션 코드의 오프셋과 비교하세요.
  5. 텍스트가 상자 또는 프레임의 가장자리에 의해 잘리지 않습니다.
  6. 시계가 story.json이 이 줄에 대해 제공하는 값을 표시합니다.
  7. 첫 번째 프레임이 이미 장소와 주요 주제를 보여줍니다.
  8. 마지막 프레임이 질문, 두 단어, 두 노트 및 "한 단어로 댓글을 남기세요"를 보여줍니다.

7단계. 수정 및 재확인

본 것을 수정하세요. 아래 목록을 사용하세요. 그런 다음 프레임을 다시 렌더링하고 다시 확인하세요. 잠시 동안 정확한 시간을 요청할 수 있습니다: --frames 6.5,7.2. 모든 프레임이 여덟 가지 검사를 모두 통과할 때까지 반복하세요. 한 번 확인하는 것만으로는 충분하지 않습니다: 수정으로 인해 문제가 이동하는 경우가 많습니다.

8단계. 동영상 렌더링

node SKILL_DIR/scripts/render.mjs last-bus

150프레임마다 진행률 줄을 출력하고 프레임 수와 소요 시간(초)으로 끝납니다. 파일은 last-bus/out/episode.mp4입니다. --out name.mp4는 이름을 변경합니다. --width, --height 및 --fps는 크기와 프레임 속도를 변경합니다(기본값 1080 x 1920, 30). 그런 다음 파일에 그림과 소리가 있는지 확인하세요:

ffprobe -v error -show_entries stream=codec_type:format=duration -of default=nw=1 last-bus/out/episode.mp4

9단계. 보고

사용자에게 알리세요: MP4의 경로, 길이, 전제, 두 단어, 창작한 모든 것, 제거할 수 없었던 경고.

알려진 실패 사례 및 수정 방법

이 네 가지는 이 방식으로 만든 첫 번째 에피소드에서 발생했습니다. 모든 확인 프레임에서 이를 찾아보세요.

  1. 모양이 입장 애니메이션이 시작되기 전에 보입니다. -cut 프레임에서 볼 수 있습니다: 나중에 도착해야 할 것이 이미 거기에 있으며, 종종 이상한 장소에 매달려 있습니다. 첫 번째 에피소드에서는 가방이 떨어지기 1초 전에 남자의 얼굴 앞에 매달려 있었습니다. 원인: 트윈이 0초부터 시작 위치에 모양을 배치하고, 그 위치가 프레임 안에 있었습니다. 수정: show('#l2-bag', l2.start + 1.0)을 사용하여 시작 시간까지 숨기고(트윈과 동일한 시간), 입장을 프레임 밖에서 시작하세요(y: -400이 아닌 y: -1400).
  2. 자막이 복잡한 영역 위에 배치됩니다. 단어가 선반, 창문, 얼굴 또는 밝은 모양 위에 놓입니다. 수정: 자막을 조용한 밴드로 이동하세요. 해당 장면의 data-caption-y를 배경이 하나의 평평한 어두운 색상인 y로 설정하거나, y 1290~1500이 조용하도록 장면을 다시 그리세요. 사물 사이에 맞추기 위해 자막을 더 작게 만들지 마세요.
  3. 주요 주제가 프레임에서 너무 작습니다. 그림이 풍경이나 방을 보여주고 사람이 멀리 있습니다. 수정: 주요 SVG 그룹의 transform에서 확대하세요(예: 배율 1.12). 동영상의 1080x1920에서 주요 주제는 그림 영역의 적어도 1/3을 차지해야 합니다.
  4. 시계가 한 번만 변경되거나 전혀 변경되지 않습니다. 모든 중간 프레임이 같은 값을 보여줍니다. 수정: story.json에서 적어도 한 줄에 대해 다른 clock 값을 입력하세요. 일반적으로 압박이 커지는 줄입니다.

안정적인 배경에도 동일한 네 가지 문제가 여러 장면에서 반복됩니다. 확인 프레임을 볼 때 항상 이 목록을 참조하세요.

관련 스킬