Communitygithub.com

Edição

Constrói uma versão em vídeo a partir da gravação do usuário: o corte do apresentador, depois um plano de edição com todos os inserts (cenas 2D, cenas 3D, gravações, palavras-chave), som e música, tudo com um comando (crewcut render). Use para: editar o vídeo, montar o corte, corte do apresentador, corte bruto, inserir, b-roll, cena 2D, insert 3D, contador, palavra-chave, fundo musical, som, montar, renderizar a prévia, nova versão do plano, versão curta a partir do vídeo longo.

O que é Edição?

O skill de Edição transforma a gravação do usuário em um vídeo completo em duas etapas principais: primeiro, o **corte do apresentador** – seleciona as melhores takes, corta nas pausas e aplica correção de cor – e depois o **plano de edição** (armazenado em `edit/plan-vNNN.json`), que define todos os inserts, suas palavras de ancoragem, dicas visuais e o áudio. O comando `crewcut render` constrói o plano final. Este skill não gerencia cores, fontes ou níveis: esses vêm do pacote de estilo (`crewcut brand show`), e as regras de gosto estão em `brand/rules/edit.md` e `brand/rules/cut.md`. O skill suporta as plataformas Claude Code, Cursor e Codex, e funciona integrado ao ecossistema Crewcut. Ele lida com cenas 2D (HTML renderizado pelo Chromium) e 3D (Blender via código), gravações, palavras-chave, fundo musical e efeitos sonoros. O processo é altamente modular: o usuário primeiro conta a mistura de inserts, depois escreve o plano com um script gerador que usa âncoras de palavras (nunca segundos manuais), e então renderiza em etapas: 2D localmente, 3D local ou em GPU alugada (com estimativa de custo), e finalmente a montagem final. O resultado é sempre marcado como "não verificado" até que o Crítico o aprove; só então a prévia é exportada e mostrada ao usuário. Regras importantes incluem: símbolo antes do texto (inserts visuais antes de cartões de texto), cenas 3D para objetos com ação e 2D para processos/números/comparações, música instrumental baixa sob a voz, e verificação de cada cena antes da montagem final. O skill também impõe limites honestos: o agente não ouve áudio, então todos os julgamentos de som dependem de listas e tempos para o usuário; a detecção de pausas ou sobreposições gera candidatos, não certezas; e a qualidade visual só pode ser avaliada por uma pessoa, comparando frames com a referência.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Edição: um plano, um comando

O Editor transforma a gravação do usuário em um vídeo em duas partes. Primeiro o corte do apresentador: as melhores takes, cortadas nas pausas, com correção de cor. Depois o plano de edição (edit/plan-vNNN.json): cada insert, suas palavras e dicas, o som. A bancada crewcut render constrói o plano. Nada neste skill define cor, fonte ou nível: esses vêm do pacote de estilo (crewcut brand show). O gosto está em brand/rules/edit.md e brand/rules/cut.md.

Leia primeiro

Você querLeia
cortar a gravação para o corte do apresentadorreferences/record-to-cut.md (som até o final, dividir arquivos, última take completa, inícios duplicados, cortes nas pausas, regravar, corrigir cor, exibir e travar)
escrever o plano, escolher ou construir uma cena, exibir uma gravaçãoreferences/plan-and-scenes.md (âncoras de palavras, contar a mistura, forma por afirmação, dicas, nova cena 2D, reutilização, gravações)
fazer música, definir níveis ou alugar uma GPUreferences/sound-and-gpu.md (música ao longo da história, escolhida por medição, níveis, armadilhas de GPU, cartão de custo)
construir uma cena 3Dskill 3d-scene
verificar antes de exibirskill cut-check (executado pelo Crítico, nunca por você)

Nomes de cenas e suas chaves de dados: templates/2d/BLOCKS.md e templates/3d/README.md. Não copie listas de chaves aqui.

Como uma versão é feita

  1. Corte do apresentador (references/record-to-cut.md): crewcut ingest, crewcut transcribe, crewcut cut …. Execute python3 skills/cut-check/scripts/cut_check.py <decisões> nele e corrija todo ERRO antes de construir sobre ele.
  2. Palavras do corte final: crewcut transcribe audio/voice-vNNN.wav → work/words-vNNN.json. Todos os tempos do plano vêm dessas palavras.
  3. Conte a mistura, depois liste os pontos (seção abaixo). Envie a lista como um cartão antes da grande renderização: crewcut card propose --episode $CREWCUT_EPISODE --step edit --kind mix --title "Inserts para v002" --file edit/mix-v002.md. Continue construindo enquanto ele estiver aberto; o cartão é uma visualização, não uma barreira.
  4. Escreva o plano com um pequeno script gerador (edit/make_plan.py) que define cada tempo a partir de uma âncora de palavra. Nunca digite segundos manualmente. Esquema: docs/architecture.md, "Plano de edição". Valores deixados como null vêm do pacote.
  5. crewcut render plan edit/plan-vNNN.json: lista cada insert com quadros e dicas. Leia. Um insert de meio segundo é uma âncora errada.
  6. crewcut render 2d edit/plan-vNNN.json: inserts 2D, localmente.
  7. 3D: crewcut render probe edit/plan-vNNN.json <id> fornece um quadro estático na metade do tamanho. Olhe para ele ao lado da referência antes de qualquer outra coisa (skill 3d-scene). Depois, a estimativa de custo e o cartão (seção "GPU alugada ou local"), então crewcut render 3d edit/plan-vNNN.json --rented --gpus N ou --local.
  8. crewcut render cut edit/plan-vNNN.json: montagem com fundo musical, acentos, digitação, lacunas, ducking e o alvo de loudness do pacote. A saída é não verificada. Diga ao Showrunner: "construído, não verificado, não mostre".
  9. Entregue a versão ao Crítico (crewcut job add --episode $CREWCUT_EPISODE --identity critic --step edit "check plan-vNNN"). Somente após ambas as verificações mostrarem 0 ERRO: a prévia vai para export/, o Showrunner a mostra como um cartão com o arquivo (crewcut card propose … --kind preview --file export/<id>-vNNN-preview.mp4), e logo após mostrar: crewcut render shown edit/plan-vNNN.json. A partir daí, qualquer mudança é uma nova versão do plano, mesmo para dois quadros.

Um texto ou número alterado: mude o plano (nova versão), execute as etapas 5 a 9. Apenas inserts alterados são renderizados novamente. crewcut render all <plan> executa 2D, 3D e corte de uma só vez quando nada precisa ser visto entre eles.

Mistura primeiro, depois o plano

Estas regras valem para todo plano, antes de qualquer quadro ser renderizado. Os limites vêm de edit-style.json.

  1. Símbolo antes do texto. Cada insert mostra primeiro algo que acontece. Um cartão de texto (headline, post) apenas onde o espectador deve ler uma fonte real: no máximo text_cards_max fontes e no máximo text_share_max dos inserts em tela cheia. keyword apenas para um número ou um nome, no máximo keywords_max, cada um com no máximo keyword_max_words palavras. Conte por tipo antes de renderizar; a verificação de estilo conta novamente.
  2. Simbólico significa 2D e 3D. 3D onde um objeto com uma ação é a ideia. Desenhado 2D para processos, quantidades, modos e comparações: formas que constroem, movem ou mudam. Por ponto, escolha o que um espectador entende em 2 segundos. Uma cena contém no máximo uma palavra ou um número, na palavra falada.
  3. A referência é o padrão, não "está renderizando". Compare com baseline.json e brand/references/. GPUs alugadas são para qualidade: resolução total, amostras suficientes, sombras suaves, bordas limpas. 2D é motion design, não um slide: as partes constroem uma após a outra, a câmera deriva um pouco, as transições são suaves.
  4. Verifique cada cena antes do corte. Um quadro estático e uma tira de 5 quadros ao lado da referência. Se parecer com uma apresentação de slides, clip art ou modelo, jogue fora e construa novamente. Poucas cenas muito boas vencem muitas medianas; reutilize uma cena de 2 a 4 vezes com outra palavra ou estado.
  5. Material real, sem ser solicitado. Um post, um anúncio ou um resultado de terceiros entra na imagem: o post como um cartão com uma marca na palavra falada, um vídeo curto de terceiros em um cartão com sua fonte visível. Nunca uma captura de tela inventada, nunca um logotipo de empresa que você inventou.
  6. A música pertence à história (references/sound-and-gpu.md). Apenas instrumentos, baixo sob a voz, com nota de fonte e direitos.
  7. Compute rápido, nunca ocioso. Enquanto as máquinas carregam, continue trabalhando localmente (plano, 2D, corte). Cada etapa remota tem um limite de tempo. No final, prove que nenhuma máquina está rodando.
  8. Mostre a lista antes da grande renderização (etapa 3): tempo, tipo, uma linha do que se vê, o número de cartões de texto.

Cenas

Cenas 2D (HTML, renderizadas pelo Chromium, estilizadas pelos tokens da marca) e cenas 3D (Blender via código, templates/3d/). Chaves de dados: templates/2d/BLOCKS.md, templates/3d/README.md. Qual forma para qual afirmação: references/plan-and-scenes.md, seção 3.

TipoCenas
2D números e quantidadescounter, bars, grid, wave
2D fontes e material realheadline, post, clip-card, cards, swap
2D ideias desenhadasarea, flow, untangle
2D sobre o apresentador (transparente)keyword
3Dobject-word, row, grid3d, stack, slide, box, scale (kit compartilhado templates/3d/stage.py)
gravação"kind": "clip" com file, at, speed: uma gravação finalizada em tela cheia

O pacote neutro envia poucas cenas 3D, gerais. As cenas próprias do usuário vão para brand/templates/ (nunca edite os modelos do aplicativo). Uma nova cena ganha uma linha em BLOCKS.md ou templates/3d/README.md e não é testada até que um quadro dela tenha sido visto.

Regras de mistura (valores do pacote)

  • Participação 3D: cerca de graphics_mix.3d dos inserts; 2D carrega os números; o apresentador está na tela entre eles.
  • Corte na palavra, não na batida. A palavra na imagem chega 0 a 3 quadros antes de ser falada.
  • Divida longos trechos do apresentador com "speaker": [{"at": s, "zoom": z}] (zoom de zoom_base para zoom_punch, nunca acima de zoom_max).
  • O apresentador nunca fica menos que speaker_min_seconds entre duas partes em tela cheia, e pelo menos speaker_open_close_seconds no início e no final.
  • Som: fundo musical em music_db com duck, um acento apenas em pontos fortes, digitação sob contadores, uma pequena lacuna na música antes do número mais importante. Loudness loudness_lufs, pico verdadeiro no máximo true_peak_db.
  • Fontes honestas: um cartão de manchete nomeia a fonte real.
  • Nunca reivindique uma verificação de visualização ou audição que não ocorreu. Esta sessão não pode ouvir: nomeie os tempos.

Quando você aplicar uma regra que vem de uma fonte nomeada, pode dizê-lo em uma linha, por exemplo crewcut say --episode $CREWCUT_EPISODE --cite "corte rápido e legendas de palavra-chave após o estilo de edição de Alex Hormozi" "…".

GPU alugada ou local

  • Quadros 3D renderizam no Blender Cycles. Local significa a CPU do contêiner: bom para provas na metade do tamanho e cenas muito curtas. Qualquer coisa maior vai para uma GPU alugada.
  • Custo primeiro. crewcut compute estimate --kind blender --frames N [--local-sec-per-frame S] imprime tempo e dinheiro para local e alugado. Coloque a estimativa em um cartão (--kind spend, título com o valor), aguarde com crewcut card wait <id>. Saída 3 significa não: renderize localmente ou descarte a cena. Apenas uma identidade com may_spend: true aluga (o Editor).
  • Sempre: quadros estáticos na metade do tamanho primeiro, depois a animação.
  • Apenas código de cena e fontes vão para uma máquina alugada. Nunca filmagens, voz, chaves ou dados privados.
  • No final: crewcut compute destroy --all-ours, depois crewcut compute ledger --episode ID; o relatório para o usuário contém o gasto e a prova de que nenhuma máquina está rodando. Também após uma falha.
  • Armadilhas e o que as ferramentas fazem sobre elas: references/sound-and-gpu.md, seção B.

Limites honestos

  • O agente não pode ouvir. Todo julgamento de música e voz é uma lista de audição com tempos para o usuário.
  • A detecção de uma pausa de palavra, um início duplicado ou um salto de nível encontra candidatos, não certezas.
  • A verificação de estilo mede limites; se uma cena parece boa, apenas uma pessoa pode dizer. Coloque os quadros ao lado da referência e diga claramente quais cenas ainda estão abaixo dela.

Planejado

  • Reajuste de tempo de renderizações 3D quando os tempos das palavras mudam alguns quadros, para não serem renderizadas novamente.
  • Música gerada em GPU alugada via crewcut compute (o estúdio fez manualmente; veja references/sound-and-gpu.md).
  • Gravações de página da web como uma etapa de renderização (Chromium está no contêiner; nenhum comando ainda).
  • Folhas de comparação (quadro da cena ao lado da referência) como um comando.
  • Um auto-teste no episódio de demonstração em examples/demo/ quando existir.

Fontes

Nenhuma conexão ou endosso dessas pessoas; pegamos ideias e escrevemos nosso próprio resumo.

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.

Habilidades Relacionadas