Communitygithub.com

shorts

YouTube Shorts를 클립(완성된 에피소드에서 추출) 또는 오리지널(독립 촬영) 모드로 제작합니다. 자동 후보 선정, 편집, 음악, 게시까지 지원합니다.

shorts란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 YouTube Shorts를 제작할 수 있게 해주는 강력한 도구입니다. Clip 모드에서는 완성된 에피소드에서 대본과 시청률 데이터를 기반으로 Shorts 후보를 자동으로 찾아내고, 9:16 비율로 얼굴을 중심으로 거친 컷을 만들며, 세로형 그래픽과 저작권이 명확한 음악을 추가합니다. 또한 Critic 단계에서 오류를 검사하여 품질을 보장합니다. Original 모드에서는 사용자가 자유롭게 이야기하면 Writer가 이를 간결하게 다듬고, 사용자의 실제 작업에서 B-roll을 가져와 촬영합니다. 게시는 Shorts당 하나의 카드 또는 사용자의 상시 승인(standing approval)을 통해 하루 최대 2개까지 가능합니다. 주요 명령어로는 "make shorts", "make a short about …", "clip this episode", "short from episode N", "publish shorts without asking", "how are my shorts doing" 등이 있습니다. 장기 영상(스킬/episode, 스킬/edit)에는 적합하지 않습니다.

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

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

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

문서

shorts은(는) 무엇을 하나요?

Short는 세로 방향(1080x1920)의 작은 에피소드로, 단계가 더 적습니다. Clip은 완성된 에피소드에서 가져오며, 사용자에게는 '예' 한 번만 필요합니다. Original은 독립적으로 촬영하여 어떤 내용이 통하는지 빠르게 테스트합니다. 데이터에 따르면 사용자가 결정합니다. 강력하지만 현재 사용자에게 의미가 없는 아이디어는 논의 없이 폐기됩니다.

모드 (Showrunner)

상황수행
에피소드가 편집됨Scout가 자체적으로 클립 후보를 찾습니다. 카드는 미리보기와 함께 또는 바로 뒤에 제공됩니다.
에피소드가 이틀 이상 온라인 상태이고 시청률 데이터가 있음Scout가 아직 Shorts로 만들어지지 않은 강력한 구절을 확인합니다. 있으면 하나의 카드를 제공합니다.
"...에 대한 쇼츠 만들어 줘"Original
"쇼츠 만들어 줘" 외 추가 언급 없음하나의 카드: 마지막 에피소드의 최대 3개 클립 후보와 3개의 오리지널 아이디어
오랫동안 영상이 없고 작업 중인 것도 없음오리지널 아이디어, 사용자가 비활성화하지 않은 경우 최대 주 1회
이미 에피소드에서 말한 오리지널 아이디어"에피소드 12에서 이미 말씀하셨습니다. 클립은 녹화가 필요 없습니다."라고 알림

자료가 있으면 클립이 우선입니다. 새 Shorts: crewcut episode new "<제목>" --short clip --from <에피소드> 또는 --short original. 그러면 단계 표시줄에 해당 단계만 표시됩니다(클립 6단계, 오리지널 9단계).

클립

  1. 후보 (Scout). crewcut cut candidates --episode <소스>는 시간과 함께 독립적인 구절을 나열합니다. 후보는 다음 조건을 충족해야 합니다: 앞선 영상 없이도 이해 가능하고 주장이나 결과를 담은 첫 문장; 화면에 증거(숫자, 비교, 결과)가 있고, 단순히 말하는 얼굴만 있는 것이 아님; 실제 끝 부분으로, 문장 중간에 잘리지 않음; 20~55초 분량으로 총 약 12개 이하의 완전한 문장으로 구성(다른 위치에서 가져올 수 있음). 시청률 데이터가 있으면 곡선이 상승하는 구절을 선호합니다. 데이터가 없으면 텍스트만 기반으로 작업했다고 말합니다. 후보를 제안하기 전에 원본과 깨끗한 음성이 있는지 확인합니다.
  2. 하나의 카드, 최고 3개: 제목, 첫 문장, 길이, 각각의 스틸 이미지, 강도 1~10 및 노력(소, 중, 대: 세로로 촬영된 영상이 있는지, 아니면 화면을 다시 녹화해야 하는지). "이 세 개 만들어" 버튼.
  3. 거친 컷 (Editor). crewcut cut short는 시작 및 끝 단어(또는 단어 시간이 맞지 않을 경우 고정 초)로 조각을 사용합니다: 원본 녹화로 돌아가서, 얼굴을 중심으로 한 9:16, 에피소드의 깨끗한 음성, 새로운 단어 시간. 조각은 절대로 컷 경계를 넘지 않습니다. 원본이 선명한 세로 자르기(1080p 가로)에 너무 작으면 만들기 전에 알리고, 만든 후에는 알리지 않습니다.
  4. 세로형 그래픽. 스타일 팩을 사용하여 세로 방향으로 다시 렌더링된 2D 장면. 화면과 웹 페이지는 세로로 다시 녹화하며(crewcut render capture), 가로 화면을 자르지 않습니다. 에피소드의 3D는 카드 또는 레이어로 제공됩니다. 새로운 세로 3D는 비용이 발생하며 카드가 필요합니다. 최대 shorts.text_cards_max개의 텍스트 카드; 모든 그림은 2초 안에 이해 가능; 텍스트보다 기호 우선; 부드러운 움직임(픽셀 단위로 커지는 것 없음).
  5. 음악. 저작권이 명확하고 소스 파일이 있는 음악만 사용(crewcut render music-bed): shorts.music_db에서 음성 아래에, 덕킹 적용, 핵심 포인트 직전에 짧은 틈. 라이선스에 명시되지 않는 한 긴 영상의 음악은 사용하지 않습니다.
  6. 검사 (Critic). crewcut cut short-check: Shorts 규칙 집합(얼굴이 프레임 안에 있는지, 얼굴이나 YouTube 버튼이 있는 오른쪽 가장자리에 텍스트가 없는지, 밝기, 스타일 팩의 길이와 템포, 리미터 헤드룸을 고려한 음량, 오디오 레벨에서 조각 경계). 연락처 시트를 확인하고, 시간 스탬프가 포함된 "들어주세요" 목록을 사용자에게 작성합니다. 사용자 외에는 아무도 소리를 듣지 않습니다. 미리보기 카드 전에 오류 0개.

오리지널

  1. 아이디어 (Scout). 출처: 사용자가 지정한 채널의 Shorts(채널 중간값 대비 조회수 기준); 사용자가 실제로 한 일(최근 에피소드, 테스트, 채팅에서 말한 내용). 경험을 지어내지 마세요. 효과가 있는 형식(Nate Herk의 50개 Shorts 분석, 구독자 100만 이상 미국 채널 기준; 방향성일 뿐 약속은 아님): Shorts가 증거인 경우("Claude가 이걸 만들었어요"), 첫 번째 선택; 놀라움이 있는 1인칭 이야기, 두 번째; 타인의 이야기, 가능; 도구 소개 및 뉴스, 피함; 거리 설문, 피함. 세 가지 아이디어가 포함된 하나의 카드: 첫 문장, 화면에 표시될 증거, 형식, 데이터 기반 근거. 증거가 없으면 아이디어도 없습니다.
  2. 사용자가 먼저 이야기하고, Writer가 간결하게 다듬습니다. 한 메시지로 23분의 자유로운 이야기(작성기의 마이크)를 요청하며, 네 가지 질문을 따릅니다: 무엇을 했나요? 전에는 어떻게 생각했나요? 무엇이 잘못되었거나 놀라웠나요? 어떤 숫자를 가지고 있나요? 사용자의 말을 유지하고 정리합니다: 나, 사건, 숫자(첫 문장이 전체 갈등을 담음); 시간 앵커 또는 연속된 숫자; 내가 생각한 것; 화면의 증거와 함께 전환(데모는 5초 이내에 실행); 지금 다르게 하는 것; 느슨한 끝. shorts.words의 길이(기본 110170단어, 30~50초).
  3. 검사 및 인간화. python3 skills/script/scripts/script_check.py <파일> --short 오류 0개까지 실행 후 Humanizer 패스(skills/script). 스크립트 카드의 버튼은 "이거 실제로 일어난 일이에요"입니다: 사용자가 이야기가 사실임을 확인합니다(--data '{"button": "This really happened"}').
  4. 녹화: 화자만, 세로 또는 자를 여유가 있는 가로, 텔레프롬프터 또는 핵심 포인트에서. 그 외에는 아무것도 없음: 화면, 손, 두 번째 각도 없음.
  5. B-roll (Editor): 사용자 작업의 실제 증거(세로 화면 녹화, 렌더링, 장면으로 표시된 숫자), 스타일 팩의 2D 장면, 팩에 있는 경우에만 3D(일반 추정치 포함). 연출된 내용 없음, 지어낸 인용 없음. shorts.layout의 레이아웃: "full" 또는 "proof-top"(위에 증거, 아래에 얼굴, 얼굴에서 끝).
  6. 클립 6단계와 동일한 검사.

제목, 썸네일, 긴 영상 링크

  • 제목 일반적인 제목 검사 적용, 더 짧게. 첫 문장과 제목이 동일한 내용을 말합니다.
  • 썸네일 (Designer): 아래쪽 가장자리가 비어 있는 세로형.
  • 링크: 패키지는 클립의 경우 related_url(긴 영상)을 가져오고, 업로드는 이를 설명에 추가하고 댓글로도 추가합니다. "관련 동영상" 및 고정은 API가 없으므로 사용자에게 YouTube Studio에서 설정하도록 한 줄로 알립니다.

게시

  • Shorts당 하나의 게시 카드. 단, 사용자가 Shorts에 대한 상시 승인을 켠 경우는 예외입니다: Shorts 게시 카드의 조용한 두 번째 버튼 또는 crewcut shorts standing on(크루 멤버로서 이 카드를 제안하며, 사용자의 '예'만이 켭니다). Shorts에만 적용되며, short-check에서 오류 0개를 찾은 후에만, 타인의 자료나 사람이 포함되지 않은 경우("third_party": true), 스타일 팩 변경 후 첫 번째 Shorts가 아닌 경우에만 적용됩니다. 모든 Shorts는 비공개로 업로드되고, 다시 읽힌 후에야 공개 또는 예약 게시됩니다. 해제: "Shorts에 대해 다시 물어보기" → crewcut shorts standing off. 상시 승인 시 API가 올바른 방법입니다: 파일을 수동으로 건드릴 필요 없음.
  • 시기: crewcut shorts slot --episode <short>는 다음 가능한 시간을 제공합니다(하루 최대 shorts.per_day_max개, shorts.publish_times에, 같은 핵심 메시지를 가진 두 개의 Shorts는 같은 날에 게시하지 않으며, 연속으로 게시하는 쌍은 허용). "한 번에 모두"는 사용자의 한 마디가 필요합니다.

결과

48시간 후: crewcut shorts results --episode <short>는 studio/shorts.tsv에 행을 추가합니다(모드, 형식, 길이, 자막, 첫 문장, 조회수, 평균 시청률, 구독자). 10개 Shorts 이후부터 Scout는 표에서 규칙을 카드로 제안할 수 있습니다("40초 미만 Shorts의 시청자 유지율이 20% 더 높습니다. 40초를 제한으로 할까요?"). 10개 이전에는 패턴에 대해 아무 말도 하지 않습니다.

정직한 한계

  • 빌드 및 단위 테스트 완료; 아직 Crewcut으로 Shorts가 완전히 제작된 적은 없습니다.
  • 고정 자르기는 화자가 중앙 근처에 있어야 합니다. 움직이는 화자를 따라가는 자르기는 계획 중입니다.
  • 시청률 데이터는 YouTube Analytics API(YouTube와 연결)가 필요합니다.

출처

  • Nate Herk (https://www.youtube.com/@nateherk): 증거로서의 Shorts; 위의 형식 순위는 그의 50개 Shorts 분석 요약입니다.
  • Farza, Chris Raroque, Roy Lee, Riley Brown, Varun Mayya 및 Codie Sanchez의 릴 스토리텔링(README의 링크): 1인칭, 전환, 불균일한 실제 숫자; 사용자가 말하고 에이전트가 간결하게 정리합니다.

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.

script

Writes the spoken script of an episode in the user's own voice (voice.md), in teleprompter form, after title and proof are fixed: opening that delivers the title's promise, small stories with rising stakes, the critical side, a verdict in its own form, the channel's closing line. skills/script/scripts/script_check.py checks form, sentences, opening, ending, numbers against the proof, and length. Delivered through the web teleprompter (crewcut prompter). Use when: \"write the script\", \"teleprompter text\", \"rewrite the script\", \"shorten the script\", \"make it sound natural\", \"script for the episode\". Not for titles or thumbnails. Short scripts: the `--short` mode of the check and skills/shorts.

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.

관련 스킬