Communitygithub.com

편집

사용자의 녹화본을 스피커 컷과 편집 플랜(2D/3D 장면, 녹화본, 키워드, 음악, 사운드 포함)으로 변환하여 하나의 명령어(crewcut render)로 완성된 비디오를 빌드합니다.

편집란 무엇인가요?

이 스킬은 사용자의 녹화본을 완전한 비디오로 변환하는 편집 과정 전체를 자동화합니다. 먼저 최고의 테이크를 선택하고, 일시 중지 지점에서 자르며, 색보정까지 완료한 '스피커 컷'을 만듭니다. 이후 모든 인서트(2D 장면, 3D 장면, 녹화본, 키워드)와 그에 맞는 단어 및 큐, 사운드 정보를 포함한 '편집 플랜'(edit/plan-vNNN.json)을 작성합니다. 최종적으로 워크벤치 명령어 `crewcut render`가 이 플랜을 바탕으로 최종 영상을 빌드합니다. 이 스킬은 색상, 폰트, 레벨과 같은 스타일 정보를 직접 관리하지 않고, 브랜드 스타일 팩(`crewcut brand show`)과 브랜딩 규칙(`brand/rules/`)에서 가져옵니다. 사용자는 먼저 스피커 컷을 생성하고(`references/record-to-cut.md`), 편집 플랜을 작성하기 전에 혼합(Mix) 구성을 먼저 결정한 후, 단어 앵커를 기준으로 자동으로 시간을 설정하는 작은 생성 스크립트를 통해 플랜을 작성합니다. 최종 렌더링 전에는 컷 체크 스킬로 오류를 검증하고, 모든 확인이 완료되면 완성된 프리뷰를 내보내고 쇼러너에게 전달합니다. 이 스킬은 Claude Code, Codex, Cursor 등 AI 에이전트 환경에서 사용되며, 영상 편집 작업을 체계적이고 반복 가능한 방식으로 수행하도록 설계되었습니다.

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

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

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

문서

편집: 하나의 플랜, 하나의 명령어

편집기는 사용자의 녹화본을 두 단계로 비디오로 변환합니다. 첫째는 스피커 컷: 최고의 테이크를 선택하고, 일시 중지 지점에서 자르고, 색보정을 적용합니다. 그 다음은 편집 플랜(edit/plan-vNNN.json): 모든 인서트, 그 단어와 큐, 사운드를 포함합니다. 워크벤치 crewcut render가 플랜을 빌드합니다. 이 스킬에는 색상, 폰트 또는 레벨이 포함되어 있지 않습니다. 이러한 요소는 스타일 팩(crewcut brand show)에서 가져옵니다. 취향(Taste)은 brand/rules/edit.md와 brand/rules/cut.md에 있습니다.

먼저 읽기

원하는 작업읽을 문서
녹화본을 스피커 컷으로 자르기references/record-to-cut.md (사운드 끝까지 유지, 파일 분할, 마지막 완전한 테이크, 이중 시작, 일시 중지에서 자르기, 재촬영, 색보정, 보여주기 및 잠금)
플랜 작성, 장면 선택 또는 구축, 녹화본 보여주기references/plan-and-scenes.md (단어 앵커, 혼합 계산, 진술별 형식, 큐, 새 2D 장면, 재사용, 녹화본)
음악 만들기, 레벨 설정, 또는 GPU 임대references/sound-and-gpu.md (스토리에 따른 음악, 측정에 의해 선택, 레벨, GPU 함정, 비용 카드)
3D 장면 구축스킬 3d-scene
보여주기 전 확인스킬 cut-check (비평가(Critic)가 실행, 사용자는 절대 실행 금지)

장면 이름과 데이터 키: templates/2d/BLOCKS.md 및 templates/3d/README.md. 여기에 키 목록을 복사하지 마십시오.

버전 생성 방법

  1. 스피커 컷(references/record-to-cut.md): crewcut ingest, crewcut transcribe, crewcut cut … 실행. python3 skills/cut-check/scripts/cut_check.py <decisions>를 실행하여 모든 ERROR를 수정한 후에야 다음 단계를 진행하십시오.
  2. 최종 컷의 단어: crewcut transcribe audio/voice-vNNN.wav → work/words-vNNN.json. 모든 플랜 시간은 이 단어들에서 가져옵니다.
  3. 혼합 계산 후, 스팟 목록 작성(아래 섹션). 큰 렌더링 전에 목록을 카드로 보내십시오: crewcut card propose --episode $CREWCUT_EPISODE --step edit --kind mix --title "v002 인서트" --file edit/mix-v002.md. 카드가 열려 있는 동안 계속 빌드하십시오; 카드는 참고용이지 승인 단계가 아닙니다.
  4. 플랜 작성: 작은 생성 스크립트(edit/make_plan.py)를 사용하여 모든 시간을 단어 앵커에서 설정합니다. 절대 초 단위로 직접 입력하지 마십시오. 스키마: docs/architecture.md, "편집 플랜". null로 남겨진 값은 팩에서 가져옵니다.
  5. crewcut render plan edit/plan-vNNN.json: 프레임과 큐가 포함된 모든 인서트를 나열합니다. 결과를 읽으십시오. 0.5초짜리 인서트는 잘못된 앵커입니다.
  6. crewcut render 2d edit/plan-vNNN.json: 2D 인서트, 로컬에서 실행.
  7. 3D: crewcut render probe edit/plan-vNNN.json <id>는 절반 크기의 정지 프레임 하나를 제공합니다. 다른 작업을 하기 전에 이것을 참조 이미지와 나란히 확인하십시오(스킬 3d-scene). 그런 다음 비용 견적 및 카드(섹션 "임대 GPU 또는 로컬")를 확인한 후, crewcut render 3d edit/plan-vNNN.json --rented --gpus N 또는 --local을 실행합니다.
  8. crewcut render cut edit/plan-vNNN.json: 음악 배경, 히트, 타이핑, 갭, 덕킹 및 팩의 음량 목표를 적용하여 어셈블리합니다. 출력물은 확인되지 않은 상태입니다. 쇼러너에게 "빌드됨, 미확인, 보여주지 마세요"라고 알리십시오.
  9. 버전을 비평가(Critic)에게 전달합니다 (crewcut job add --episode $CREWCUT_EPISODE --identity critic --step edit "check plan-vNNN"). 두 검사 모두 0 ERROR를 보인 후에만 프리뷰가 export/로 이동하고, 쇼러너가 파일과 함께 카드로 표시합니다(crewcut card propose … --kind preview --file export/<id>-vNNN-preview.mp4). 표시 직후: crewcut render shown edit/plan-vNNN.json. 그 이후로는 2프레임 변경이라도 모든 변경은 새로운 플랜 버전을 의미합니다.

변경된 텍스트나 숫자: 플랜을 변경하고(새 버전), 5~9단계를 실행합니다. 변경된 인서트만 다시 렌더링됩니다. crewcut render all <plan>은 중간 확인이 필요 없을 때 2D, 3D 및 컷을 한 번에 실행합니다.

먼저 혼합, 그 다음 플랜

이 규칙은 모든 플랜에 적용되며, 프레임 하나가 렌더링되기 전에 적용됩니다. 제한은 edit-style.json에서 가져옵니다.

  1. 텍스트보다 상징. 모든 인서트는 먼저 어떤 일이 일어나는지를 보여줍니다. 텍스트 카드(headline, post)는 시청자가 실제 출처를 읽어야 하는 경우에만 사용됩니다: 최대 text_cards_max개의 출처, 전체 화면 인서트 중 최대 text_share_max 비율. keyword는 숫자나 이름에만 사용하며, 최대 keywords_max개, 각각 최대 keyword_max_words 단어. 렌더링 전에 종류별로 개수를 세십시오. 스타일 검사도 다시 셉니다.
  2. 상징은 2D와 3D를 의미합니다. 3D는 행동이 있는 객체가 아이디어일 때 사용합니다. 프로세스, 양, 방법 및 비교에는 그려진 2D(모양이 구축, 이동 또는 변경됨)를 사용합니다. 스팟별로 시청자가 2초 안에 이해할 수 있는 것을 선택하십시오. 장면은 말하는 단어 위에 최대 하나의 단어 또는 하나의 숫자를 담습니다.
  3. 기준은 참조 이미지이며, "렌더링된다"가 아닙니다. baseline.json 및 brand/references/와 비교하십시오. 임대 GPU는 품질을 위한 것입니다: 전체 해상도, 충분한 샘플, 부드러운 그림자, 깨끗한 가장자리. 2D는 모션 디자인이지 슬라이드가 아닙니다: 파트가 하나씩 구성되고, 카메라가 약간 움직이며, 전환이 부드럽습니다.
  4. 컷 전에 모든 장면을 확인하십시오. 참조 이미지 옆에 정지 프레임과 5프레임 스트립을 놓고 비교하십시오. 슬라이드 데크, 클립 아트 또는 템플릿처럼 보이면 버리고 다시 만드십시오. 평균적인 장면 여러 개보다 아주 좋은 장면 몇 개가 더 좋습니다. 장면을 다른 단어나 상태로 2~4회 재사용하십시오.
  5. 요청 없이 실제 자료를 사용하십시오. 게시물, 발표, 또는 제3자 결과는 그림에 포함됩니다: 게시물은 말하는 단어에 표시가 있는 카드로, 제3자 비디오 짧은 클립은 출처가 보이는 카드로 표시합니다. 절대 가상의 스크린샷이나 지어낸 회사 로고를 사용하지 마십시오.
  6. 음악은 스토리에 속합니다(references/sound-and-gpu.md). 악기만 사용하고, 음성 아래에서 조용하게, 출처와 권리 표시를 포함하십시오.
  7. 빠르게 계산하고, 유휴 상태가 되지 마십시오. 기계가 로드되는 동안 로컬에서 계속 작업하십시오(플랜, 2D, 컷). 모든 원격 단계에는 시간 제한이 있습니다. 마지막에는 어떤 기계도 실행 중이 아님을 증명하십시오.
  8. 큰 렌더링 전에 목록을 표시하십시오(3단계): 시간, 종류, 보이는 내용 한 줄, 텍스트 카드 수.

장면

2D 장면(HTML, Chromium으로 렌더링, 브랜드 토큰으로 스타일링) 및 3D 장면(코드로 Blender, templates/3d/). 데이터 키: templates/2d/BLOCKS.md, templates/3d/README.md. 각 진술에 대한 형식: references/plan-and-scenes.md, 섹션 3.

종류장면
2D 숫자와 양counter, bars, grid, wave
2D 출처와 실제 자료headline, post, clip-card, cards, swap
2D 그려진 아이디어area, flow, untangle
2D 스피커 위에 (투명)keyword
3Dobject-word, row, grid3d, stack, slide, box, scale (공유 키트 templates/3d/stage.py)
녹화본"kind": "clip" with file, at, speed: 전체 화면으로 표시되는 완성된 녹화본

중립 팩은 일반적인 소수의 3D 장면을 제공합니다. 사용자 자신의 장면은 brand/templates/에 들어갑니다(앱의 템플릿을 편집하지 마십시오). 새 장면은 BLOCKS.md 또는 templates/3d/README.md에 한 줄을 추가하며, 해당 장면의 프레임이 확인되기 전까지는 테스트되지 않습니다.

혼합 규칙 (팩의 값 사용)

  • 3D 비율: 인서트의 약 graphics_mix.3d; 2D가 숫자를 담당합니다. 스피커는 그 사이에 화면에 나타납니다.
  • 단어에 맞춰 자르고, 비트에 맞추지 마십시오. 그림 속 단어는 말하기 0~3프레임 전에 나타납니다.
  • 긴 스피커 구간은 "speaker": [{"at": s, "zoom": z}]로 분할합니다(zoom은 zoom_base에서 zoom_punch까지, zoom_max를 초과하지 않음).
  • 스피커는 두 개의 전체 화면 부분 사이에 speaker_min_seconds보다 짧지 않아야 하며, 시작과 끝에 최소 speaker_open_close_seconds 이상 유지되어야 합니다.
  • 사운드: music_db의 음악 배경에 duck 적용, 강한 지점에서만 히트, 카운터 아래에 타이핑, 가장 중요한 숫자 앞에 음악 짧은 갭. 음량 loudness_lufs, 실제 피크 true_peak_db 이하.
  • 출처 정직: 헤드라인 카드는 실제 출처를 명명합니다.
  • 발생하지 않은 시청 또는 청취 확인을 절대 주장하지 마십시오. 이 세션은 들을 수 없습니다: 시간을 명시하십시오.

명명된 출처에서 비롯된 규칙을 적용할 때, 한 줄로 언급할 수 있습니다. 예: crewcut say --episode $CREWCUT_EPISODE --cite "Alex Hormozi의 편집 스타일을 따른 빠른 컷과 키워드 캡션" "…"

임대 GPU 또는 로컬

  • 3D 프레임은 Blender Cycles에서 렌더링됩니다. 로컬은 컨테이너의 CPU를 의미합니다: 절반 크기의 프로브와 매우 짧은 장면에 적합합니다. 그 이상은 임대 GPU로 이동합니다.
  • 비용 우선. crewcut compute estimate --kind blender --frames N [--local-sec-per-frame S]는 로컬 및 임대에 대한 시간과 비용을 출력합니다. 견적을 카드에 넣고(--kind spend, 금액 포함 제목), crewcut card wait <id>로 기다리십시오. 종료 코드 3은 거부를 의미합니다: 로컬로 렌더링하거나 장면을 포기하십시오. may_spend: true가 있는 ID만 임대할 수 있습니다(편집자).
  • 항상: 먼저 절반 크기의 정지 프레임, 그 다음 애니메이션.
  • 장면 코드와 글꼴만 임대 기계로 보냅니다. 절대 푸티지, 음성, 키 또는 개인 데이터는 보내지 마십시오.
  • 마지막: crewcut compute destroy --all-ours, 그 다음 crewcut compute ledger --episode ID; 사용자에게 보고서는 지출액과 어떤 기계도 실행 중이 아님을 증명하는 내용을 담습니다. 실패 후에도 마찬가지입니다.
  • 함정 및 도구가 이를 해결하는 방법: references/sound-and-gpu.md, 섹션 B.

정직한 한계

  • 에이전트는 들을 수 없습니다. 모든 음악 및 음성 판단은 사용자를 위한 시간이 표시된 청취 목록입니다.
  • 단어의 나머지 부분, 이중 시작 또는 레벨 점프 감지는 후보를 찾을 뿐 확실하지 않습니다.
  • 스타일 검사는 제한을 측정합니다. 장면이 좋아 보이는지는 사람만이 말할 수 있습니다. 프레임을 참조 이미지 옆에 놓고 아직 기준에 미치지 못하는 장면을 솔직히 말하십시오.

계획됨

  • 단어 시간이 몇 프레임 이동할 때 3D 렌더링 시간 재조정하여 다시 렌더링하지 않도록 함.
  • crewcut compute를 통해 임대 GPU에서 생성된 음악 (스튜디오에서 수동으로 수행, references/sound-and-gpu.md 참조).
  • 웹 페이지 녹화를 렌더 단계로 (Chromium이 컨테이너에 있음, 아직 명령어 없음).
  • 비교 시트 (장면 프레임을 참조 이미지 옆에)를 하나의 명령어로.
  • examples/demo/의 데모 에피소드에 대한 자체 테스트 (일단 생성되면).

출처

이 사람들과의 연결 또는 보증은 없습니다. 아이디어를 참고하여 자체 요약을 작성했습니다.

  • Alex Hormozi (편집 및 캡션 스타일은 그의 편집자 Ryan Magin이 제작), https://www.youtube.com/@AlexHormozi: 단어에 맞춘 빠른 컷과 짧은 단어 캡션; 여기서는 키워드 캡션으로 축소됨.
  • fern (YouTube 채널), https://www.youtube.com/@fern-tv: 3D 클레이 룩에 대한 영감만 제공. 그 외의 값은 가져오지 않음.

Individual skills in this repo

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

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.

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.

관련 스킬