Community라이팅 & 에디팅github.com

스크립트

에피소드의 대본을 사용자의 목소리(voice.md)로, 제목과 증거가 확정된 후 텔레프롬프터 형식으로 작성합니다.

스크립트란 무엇인가요?

이 스킬은 AI 에이전트(Claude Code, Cursor, Codex 등)가 동영상 에피소드의 대본을 사용자의 실제 말투와 스타일로 작성하도록 돕습니다. 'voice.md' 파일의 음성 프로필과 'brand/rules/script.md'의 브랜드 규칙을 참고하며, 제목과 증거 파일이 먼저 승인되어야 작업을 시작할 수 있습니다. 대본은 오프닝, 문제 제기, 기능 설명, 자체 테스트, 구독 유도, 상승하는 stakes의 작은 이야기들, 비판적 측면, 독자적인 평결, 채널 종료 멘트로 구성된 구조를 따릅니다. 'script_check.py' 도구로 형식, 문장, 오프닝, 엔딩, 숫자 및 길이를 검증하며, 'crewcut prompter'를 통해 웹 텔레프롬프터로 전달됩니다. 모든 초안은 사용자에게 보여지기 전에 Humanizer(blader/humanizer)를 거쳐 자연스러운 음성으로 다듬어집니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/marcopatzelt/crewcut/tree/HEAD/skills/script

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

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

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

문서

스크립트은(는) 무엇을 하나요?

작성자는 사용자가 동영상에서 말하는 내용을 작성합니다. 목표: 사용자가 한 번 읽고 녹화합니다. 모든 문장은 제목과 썸네일의 약속을 전달하거나 증명합니다.

작성 전 확인 사항

  1. 제목과 썸네일 텍스트가 승인되었습니다(brief/TITLE-vNNN.md). 제목이 없으면 스크립트도 없습니다.
  2. 증거가 승인되었습니다(brief/PROOF-vNNN.md). 숫자, 경험, 인용문을 절대 지어내지 마세요. 누락된 내용이 있으면 작성 전에 채팅(crewcut say)을 통해 질문하세요. 스크립트에는 공백이나 자리 표시자가 없어야 합니다.
  3. voice.md(사용자의 말투, 사용할 단어와 피해야 할 단어), brand/rules/script.md, 그리고 edit-style.json의 길이(length_minutes)와 channel.json의 말하기 속도(script.words_per_minute)를 읽으세요.
  4. 최근 세 개 스크립트의 엔딩을 읽어서 이번 평결이 새로운 형태를 취하도록 하세요.

구조

두 가지 형태가 있습니다. 도구나 주장에 대해서는 테스트 형식을 사용하고, 무슨 일이 발생했을 때는 스토리 형식을 사용하세요(자세한 내용은 references/forms.md 참조).

  1. 오프닝, 2~6문장. 첫 몇 초는 약속과 그 숫자를 전달합니다: 문장 1은 도구나 주제와 그 주장을 명명합니다. 인사말, 질문, "이 동영상에서는"이 없어야 합니다. 처음 30초는 클릭을 확인시켜 줍니다: 시청자는 제목과 썸네일이 약속한 동영상을 보게 되었음을 알게 됩니다. 최대 하나의 열린 루프(open loop)가 있으며, 끝에서 해결됩니다.
  2. 문제, 시청자가 알고 있는 사례를 들어 설명합니다. 처음 등장하는 알려지지 않은 도구는 설명합니다.
  3. 기능, 그림으로 설명하며, 시청자가 아직 모르는 것만 보여줍니다.
  4. 자체 테스트, 실제 숫자로, 사람들이 말하는 방식으로 반올림합니다. 도구가 만들어진 목적에 맞는 테스트만 수행합니다.
  5. 구독 유도 한 줄, 첫 번째 강력한 결과 직후에: 시청자가 채널에서 얻는 것. 공급업체가 테스트 비용을 지불하지 않으면 그 줄에 그렇게 명시합니다. 절대 시작 부분에 넣지 말고, 끝에 애원하는 식으로 넣지 마세요.
  6. 상승하는 stakes의 작은 이야기들. 오프닝과 평결 사이의 각 블록은 목표, 장애물, 해결책을 가집니다. 블록에서 블록으로 stakes가 상승합니다(더 많은 데이터, 더 많은 돈, 더 어려운 테스트). 가장 강력한 테스트는 평결 직전 마지막에 옵니다; 오프닝에서 언급할 수는 있지만 미리 공개하지는 마세요.
  7. 비판적 측면. 공급업체의 수치 대 자체 측정 또는 독립적인 측정; 한계. 도구가 약속을 지키지 못하면 그렇게 말하고, 제목은 제목 단계로 돌아갑니다.
  8. 평결, 매번 독자적인 형태로: 시청자를 위한 과제, 기억에 남는 하나의 숫자, 시청자 자신의 작업에 의미하는 바, 오프닝 이미지로의 회귀. 고정된 마무리 질문이 아닙니다.
  9. 엔딩. channel.json에 제안이나 필수 언급(script.end_mentions)이 있으면 마지막 문장들에 사용자의 말투로 포함됩니다. closing_line이 있을 경우 마지막 문장은 채널의 종료 멘트입니다.

비교 동영상: 동일한 구성을 가진 블록은 최대 두 개까지 연속으로 허용되며, 세 번째는 형태를 바꿉니다. 중간 지점에 새로운 갈고리(hook)를 넣습니다. 각 진술은 한 번만 합니다. 모든 후보의 비용과 시간은 각 블록 끝이 아니라 한 번에, 함께 화면에 표시합니다.

단어

  • voice.md에서 사용자의 단어를 사용합니다. 피해야 할 목록에 있는 단어는 절대 사용하지 않습니다.
  • 짧은 문장: 중간값 약 10~12단어, script.sentence_max_words를 초과하지 않습니다.
  • 한 문장에 제품 이름은 최대 세 개까지; 더 긴 목록은 화면에 표시합니다.
  • 제외: 시청자가 이미 알고 있는 기본 지식, 아무도 신경 쓰지 않는 세부 사항(테스트 횟수, 내부 스위치), 파일 이름, 명령어, 부차적인 주제, 사적인 사람들, 예시를 선택한 이유, 약속의 일부가 아닌 비용.
  • 광고나 판매 톤 금지: 테스트한 내용을 말하고, 시청자에게 아무것도 약속하지 않습니다. 오프닝에서 "이것이 아니라 저것" 같은 과장된 표현은 쓰지 않습니다.
  • 비즈니스는 예시를 통해 보여주고, 시청자의 비즈니스를 직접 언급하지 않습니다.

텔레프롬프터 형식

사용자는 카메라 옆에 있는 휴대전화에서 읽습니다.

  • 구분선 --- 위에는 말하는 텍스트만 있습니다. 편집을 위한 메모(장면, 클립, 각 숫자의 출처)는 구분선 아래에 작성합니다.
  • 단락은 한 호흡: 1~script.paragraph_max_sentences개의 문장. 빈 줄 하나는 짧은 휴지입니다.
  • 빈 줄 세 개는 부분을 구분합니다: 편집자가 여기서 컷할 수 있고, 텔레프롬프터가 여기서 페이지를 넘기고, 클립이 재생될 수 있습니다.
  • 대괄호, 무대 지시, 제목, 장, 타임스탬프 또는 제목 행이 없습니다. 대시는 팩에서 허용하는 경우에만 사용합니다.
  • 단락의 핵심 단어 한두 개를 굵게 표시합니다. 텔레프롬프터의 포인트 모드는 전체 텍스트 대신 이 단어들을 표시하여, 자유롭게 말하고 싶은 사용자를 돕습니다.

단계

  1. 입증된 숫자로 구조를 채웁니다.
  2. 삭제: 모든 문장이 약속을 전달하거나 증명합니다.
  3. 사용자의 목소리로 바꿉니다. 모든 문장을 머릿속으로 읽어보세요: 사용자가 카메라 앞에서 이렇게 말할까요?
  4. 초안을 work/script-draft-vNNN.md에 다음 사용 가능한 번호로 작성합니다. 이전 버전을 덮어쓰지 마세요.
  5. Humanizer 패스 (아래 참조). 결과를 brief/SCRIPT-vNNN.md(같은 번호)에 기록한 후 기록합니다: crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<적용된 패턴>".
  6. 오류가 0이 될 때까지 확인합니다: python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<제목>" --name "<도구>" --proof brief/PROOF-vNNN.md. 모든 경고와 힌트를 읽으세요; 유지하기로 결정한 힌트는 --- 아래에 한 문장으로 이유를 적습니다. 확인을 통과하기 위해 스크립트를 변경한 경우 패스를 다시 기록하세요: 카드에는 정확한 파일의 기록이 필요합니다.
  7. 카드: crewcut card propose --episode <id> --step script --kind script --title "Script, version N" --file brief/SCRIPT-vNNN.md --body "<단어 수>, 약 <분> 분, 확인: 0 errors", 그 다음 crewcut card wait. 카드에 "Humanized"와 변경된 내용이 표시됩니다. 기록이 없으면 거부되며 실행해야 할 명령이 표시됩니다.
  8. 승인 후: crewcut prompter <id>는 휴대전화 링크와 QR 코드를 출력합니다. 사용자에게 한 메시지로 알립니다: 링크, 몇 부분으로 나뉘는지, 대략적인 길이. 텔레프롬프터는 --- 위의 텍스트만 표시합니다.

Humanizer 패스

모든 스크립트 초안은 사용자에게 보여지기 전에 Humanizer(blader/humanizer, MIT)를 거칩니다: 긴 동영상과 Shorts 모두 마찬가지입니다. Crewcut은 시작 시 최신 버전을 다운로드합니다; Claude Code에서는 humanizer:humanizer 스킬(다른 스킬처럼 실행)이며, Codex에서는 그 텍스트가 프롬프트에 포함됩니다. crewcut skills status 명령어로 버전을 확인할 수 있습니다.

  • 모드 "Embedded", 사용자의 목소리로. 먼저 brand/voice/의 모든 파일을 읽으세요: 사용자가 자신의 동영상에서 말한 실제 단어들. 이 파일들을 Humanizer에 음성 샘플로 제공하세요. 샘플이 없으면 일반 모드(plain mode)를 사용하며, 카드에 그렇게 명시됩니다.
  • 가장 주의 깊게 봐야 할 것: "X가 아니라 Y" 대비; 새로운 내용을 추가하지 않는 종료 멘트; 깊어 보이는 속담; 요점 앞의 연출된 준비("바로 이겁니다"); 세 가지 목록; 부풀려진 의미와 광고 언어.
  • 유지할 것: 사용자의 고유한 단어와 표현(brand/voice/와 voice.md에 있는 것). Humanizer가 부드럽게 다듬으려 해도 그대로 둡니다. 모든 숫자, 이름, 주장, 제목의 약속은 유지합니다. 패스는 말투를 바꾸되, 내용은 절대 바꾸지 않습니다.
  • 범위 밖: 텍스트가 AI 탐지기를 통과하도록 만드는 것. Humanizer는 사람을 위해 편집하며, 우리도 그렇습니다.

확인 도구가 볼 수 없는 것

예시가 너무 광범위해지지 않는지, 일부가 주제에서 벗어나지 않는지, 테스트가 약속에 부합하는지, 목소리가 사용자처럼 들리는지. 이것은 2단계와 3단계에서 읽는 작업입니다.

계획된 기능

  • 큐 시트와 파트당 두 테이크(첫 번째 테이크는 큐 시트 없이, 두 번째는 스크립트에서; 편집자는 더 나은 테이크를 선택): 형식은 references/forms.md에 있습니다. 체커와 테이크 믹서(studio의 zettel.py)는 아직 포팅되지 않았습니다.
  • 스크립트 대 녹음: 승인된 스크립트를 녹음 파일 전사본과 비교하여 사용자의 실제 단어를 학습합니다(이 전사본은 새로운 음성 샘플이 될 수 있습니다).
  • 언어별 구문 체크리스트(필러 단어, 판매 문구)를 voice.md의 데이터로 추가.

출처

Individual skills in this repo

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

edit

Builds a video version from the user's recording: the speaker cut, then one edit plan with all inserts (2D scenes, 3D scenes, recordings, keywords), sound and music, built with one command (crewcut render). Use for: edit the video, build the cut, speaker cut, rough cut, insert, b-roll, 2D scene, 3D insert, counter, keyword, music bed, sound, assemble, render the preview, new plan version, short from the long video.

shorts

Makes YouTube Shorts in two modes: Clip (cut from a finished episode: candidates from the transcript and retention, a 9:16 rough cut from the original recording around the face, portrait graphics, music with clear rights, the Critic's own Short check) and Original (a Short recorded for itself: three ideas with a proof from the user's real work, the user talks freely, the Writer shortens, only the speaker is recorded, the crew brings the B-roll). Publishing: one card per Short, or the user's own standing approval for Shorts; at most two a day. Use when: \"make shorts\", \"make a short about …\", \"clip this episode\", \"short from episode N\", \"publish shorts without asking\", \"how are my shorts doing\". Not for long videos (skills/episode, skills/edit).

title

Writes and checks the YouTube title and the thumbnail text of an episode, before the script. Delivers five candidates with a hook and a reason each, one recommendation, and three variants for the A/B test; skills/title/scripts/title_check.py checks every candidate against the style pack. Use when: \"title\", \"video title\", \"YouTube title\", \"what should the video be called\", \"check this title\", \"shorten the title\", \"better title\", \"thumbnail text\". Not for the blog's search title and not for the thumbnail image.

관련 스킬