Communitygithub.com

긴 영상 스토리

긴 영상 제작 워크플로의 2단계입니다. 사용자가 직접 스토리를 제공하거나, 클로드가 스토리를 작성합니다. 스토리가 명시적으로 승인될 때까지 이 단계는 종료되지 않습니다.

긴 영상 스토리란 무엇인가요?

이 스킬은 긴 영상 제작 과정의 2단계로, 사용자가 제공하거나 클로드가 생성한 스토리를 승인하는 단계입니다. 사용자가 스토리를 직접 가지고 있거나, 클로드에게 작성을 요청할 수 있습니다. 클로드가 작성할 경우, 먼저 스토리 스타일(예: 틈새 발견, 자극적인 질문 내레이션 등)을 선택하도록 한 뒤, 해당 스타일의 스킬을 실행하여 초안을 작성하고 사용자의 승인을 받을 때까지 수정합니다. 이 스킬은 'long-video-setup' 이후 또는 사용자가 "영상 스토리"나 "아이디어를 줘"라고 말할 때 사용합니다. 스토리가 명시적으로 승인될 때만 이 단계가 종료되며, 그 전에는 다음 단계로 넘어가지 않습니다. 프로젝트 설정(config)에서 길이, 언어, 대상, 톤, 형식 등을 불러와 활용하며, 스토리 초안은 'story.md' 파일에 저장됩니다.

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

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

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

문서

긴 영상 스토리은(는) 무엇을 하나요?

긴 영상 워크플로의 2단계입니다. 결과물: 프로젝트 폴더에 승인된 story.md 파일.

이 단계는 클로드와 사용자가 스토리에 동의할 때만 종료됩니다. 이후 단계는 그 전에 시작되지 않습니다.

시작하기 전에

  1. 활성 프로젝트를 찾습니다: ~/.long-video/projects/<slug>/project.json. 사용자가 여러 개 있으면 어느 프로젝트인지 물어보세요.
  2. 프로젝트가 없으면 먼저 long-video-setup을 실행하세요.
  3. ~/.long-video/configs/<config-name>.json에서 프로젝트 설정을 불러옵니다. 길이, 언어, 대상, 톤, 형식, 시각적 접근법에 사용합니다. 설정이 이미 답변한 내용은 다시 묻지 마세요.
  4. story.md가 이미 존재하고 상태가 draft이면 계속 작업할 것인지 제안하세요. 상태가 approved이면 다시 열 것인지 물어보세요.

1단계: 입장 질문

질문: "스토리가 있나요, 아니면 제가 작성해 드릴까요?"

  • 스토리가 있습니다. 사용자가 붙여넣거나 설명합니다. 5단계로 이동합니다.
  • 작성해 주세요. 2단계로 이동합니다.
  • 대략적인 아이디어가 있습니다. 사용자가 시드(주제, 테마, 한 줄)를 제공합니다. 저장한 후 2단계로 이동합니다.

2단계: 스토리 스타일 물어보기

클로드가 스토리를 작성할 때는 항상 이 질문을 해야 합니다. 건너뛰지 말고, 사용자를 대신해 스타일을 선택하지 마세요.

  1. references/story-styles.md를 읽습니다. 설치된 스타일 스킬을 확인하세요.
  2. 사용 가능한 스타일을 각각 한 줄 설명과 함께 보여줍니다. 항상 open을 포함하세요.
  3. 사용자에게 하나를 선택하라고 하세요. 직접 스타일을 설명할 수도 있습니다. 그 경우 open으로 처리하며 설명을 추가 지시사항으로 포함합니다.
  4. 선택 내용을 project.json에 "story_style": "<id>"로 저장합니다.

3단계: 주제 얻기

선택한 스타일의 유형을 따릅니다.

  • ideas (예: niche): 스타일 스킬을 호출합니다. 설정 요약과 시드가 있으면 전달합니다. 주제를 반환합니다. 그런 다음 사용할 작가(레지스트리의 4단계 페어링 규칙)를 물어보세요.
  • writer (예: questions): 사용자에게 주제나 시드가 있으면 사용합니다. 없으면 물어보세요. 주제를 제안하지 마세요.
  • open: 아래와 같이 아이디어를 제안합니다.

Open 스타일: 아이디어 제안

  1. 시드가 없으면 최대 3개의 짧은 질문을 합니다: 주제 분야나 관심사, 피해야 할 것, 사용할 실제 사건이나 출처.
  2. 설정에 맞는 4개의 제안을 작성합니다. 각 제안에는 제목, 한 문장 로그라인, 처음 15초 후크, 이 대상에게 적합한 이유가 포함됩니다.
  3. 4개의 제안이 서로 명확히 다르게 만듭니다.
  4. 사용자에게 하나를 선택하거나, 두 개를 합치거나, 더 요청하거나, 새로운 방향을 제시하라고 하세요. 사용자가 선택할 때까지 반복합니다.

4단계: 스토리 작성

작가를 호출합니다.

  • 작가 스킬 (예: long-video-story-questions): 주제, 대상 길이, 언어, 설정 요약을 전달합니다. 자체 출력 형식이 우선합니다. 기본 구조로 변형하지 마세요.
  • open: 아래 기본 구조를 작성합니다.

기본 구조 (open 스타일)

설정의 대상 길이와 일치시킵니다. 음성 내레이션은 분당 약 150단어이므로 15분 영상에는 약 2250단어가 필요합니다. 지금 최종 대본을 작성하지 마세요. 스토리를 작성하세요: 무슨 일이 일어나는지, 순서대로, 사용자가 평가할 수 있을 만큼 충분한 세부 정보.

  1. 제목 (임시).
  2. 로그라인.
  3. 후크. 처음 15~30초.
  4. 스토리 개요. 막 또는 장. 각각: 무슨 일이 일어나는지, 전환점, 대략적인 런타임 비율.
  5. 전체 스토리. 산문 형식의 처음부터 끝까지 서술.
  6. 엔딩 및 행동 촉구.
  7. 확인해야 할 사실. 출처가 필요한 모든 사실 주장을 나열합니다. 순수 픽션이면 "없음"이라고 작성합니다.

open 스타일 규칙:

  • 논픽션 스토리에 사실을 지어내지 마세요. 알 수 없는 내용은 "확인해야 할 사실"에 표시합니다.
  • 기존 작품을 복사하지 마세요. 독창적인 구조와 표현을 사용합니다.
  • 설정의 언어와 톤을 유지합니다.

초안 저장

다음 헤더와 함께 story.md에 저장합니다. 상태는 draft:

---
title: <임시 제목>
status: draft
revision: 1
style: <스타일 ID>
writer: <작가 ID 또는 "open">
config: <설정 이름>
---

헤더 아래에 텍스트를 넣습니다. 채팅에 스토리를 보여줍니다.

5단계: 확인 또는 수정

1단계에서 사용자가 직접 스토리를 가져온 경우 먼저 위의 헤더(style: user)와 함께 story.md에 저장합니다.

질문: 승인 또는 변경 요청. 스토리 이후 새 메시지로 질문하세요. 작가 스킬 출력 안에 질문을 넣지 마세요.

  • 변경 요청. 적용합니다. 작가 스킬이 텍스트를 만든 경우 편집 시 해당 규칙(형식, 톤, 정직성)을 유지합니다. revision을 증가시킵니다. 변경된 내용을 두세 줄로 보여준 후 업데이트된 스토리를 보여줍니다. 다시 질문합니다.
  • 질문 또는 의문. 답변합니다. 답변이 문제를 드러내면 변경을 제안합니다.
  • 다른 스토리 원함. 2단계로 돌아갑니다. 이전 파일을 story.rev<N>.md로 유지합니다.
  • 승인. 명시적인 '예'가 필요합니다. 침묵, "지금까지 괜찮아 보인다" 또는 "좋지만..."은 승인이 아닙니다. 불명확하면 한 가지 직접 질문을 합니다: "이 스토리를 확정할까요?"

승인될 때까지 반복합니다. 사용자를 서두르지 마세요.

6단계: 확정

  1. story.md 프론트 매터에서 status: approved로 설정합니다. approved: <ISO 날짜>를 추가합니다.
  2. project.json 업데이트: "stage": "story-approved"로 설정합니다.
  3. 사용자에게 파일 경로를 알려줍니다. 스토리 단계가 완료되었다고 말합니다.
  4. long-video-assets(캐릭터, 환경, 객체 및 스타일)로 계속할 것을 제안합니다. 사용자가 동의할 때만 시작합니다.

규칙

  • 명시적인 '예' 없이 스토리를 승인된 것으로 표시하지 마세요.
  • 승인된 스토리를 조용히 변경하지 마세요. 다시 열려면 사용자의 요청이 필요하며 상태를 draft로 되돌립니다.
  • 클로드가 스토리를 작성할 때 스타일 질문을 건너뛰지 마세요.
  • 설치되지 않은 스타일 스킬을 호출하지 마세요.
  • 제안과 수정은 짧게 유지하세요. 전체 텍스트는 스토리 자체에만 보여줍니다.

Individual skills in this repo

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

long-video-assets

Video and animation skill. Build the visual foundation for a long video from an approved story. Extracts the recurring characters, environments and key objects, helps the user choose one art style from suggested options (10 at a time, more on request), then writes image generation prompts for every character (portrait plus character sheet), environment and object, all sharing one locked style. Can also generate the images (installed tool, API, MCP or browser) or hand the user a folder and file names to fill. Use after lon

long-video-director

Turn an approved story into a shot-by-shot video script, acting as the director. Asks whether the video uses a narrator or characters who speak (or both), suggests professional filming choices (camera type, lenses, camera movement, lighting, color, pacing), saves them as a separate film style file, then writes a script that matches the project config. Outputs film-style.md and video-script.md. Use after long-video-story (and long-video-assets) are done, or when the user asks for the video script, shot list, camera style or lighting plan.

long-video-keyframes

Create the start and end frame image for every scene (clip) of the approved video script. Writes one image prompt per frame with a fixed file name that holds the scene number and start or end, makes a folder for the images, and can generate the images with an available image tool, or hand the prompts to the user all at once or one by one. Use after long-video-director, or when the user asks for start frames, end frames, keyframes or scene images.

long-video-render

Assemble the finished video and run the review loop. Builds the edit from the clips (or images with camera moves), voice, sound stems and captions, renders a low quality review version with scene numbers and time burned in so a client can review it, collects and applies changes (re-rendering reviews as often as needed), and when the user approves, renders the high quality final video. Uses a video editor with a CLI or MCP (FilmCraft, EffectCraft or another) if one is available and the user wants it, otherwise the bundled ffmpeg renderer. Use after long-video-sound, or when the user asks to render, assemble, export, preview or finalize the video.

long-video-sound

Video and animation skill. Create the sound effects, ambience and background music for the video and place them on the timeline. Plans the sound design from the approved script, sources or makes each sound (Openverse for openly licensed recordings and music, Earshot to make sounds from words and to listen to and judge sounds, Clipwing real-sfx to place real sounds on exact frames), records licences and credits, and mixes separate stems (effects, ambience, music) with the music ducked under speech. Or gives the user a fold

long-video-voice

Create the spoken audio (narration and character voices) for the approved video script. First decides whether the video needs speech and asks the user to confirm. If yes, builds a voice cast (narrator plus each speaking character), makes a short sample of each voice with an available tool such as an ElevenLabs MCP and asks the user to approve the voices, then generates one audio file per spoken line with a name that holds the scene number and speaker. Or gives the user the lines, file names and folder to record or generate themselves. Use after long-video-clips (or long-video-keyframes), or when the user asks for narration, voiceover, voices or dialogue audio.

관련 스킬