CommunityEscrita e Ediçãogithub.com

script

Escreve o roteiro falado de um episódio na própria voz do usuário (voice.md), em formato de teleprompter, após o título e a prova estarem definidos: abertura que cumpre a promessa do título, pequenas histórias com apostas crescentes, o lado crítico, um veredito em sua própria forma, a frase de encerramento do canal.

O que é script?

Esta skill, chamada "script", é um assistente especializado na criação de roteiros para vídeos, no formato de teleprompter, na voz autêntica do usuário. Ela é projetada para garantir que cada frase do roteiro cumpra a promessa estabelecida pelo título e thumbnail do vídeo, seguindo uma estrutura narrativa rigorosa. A skill suporta a verificação automática do roteiro através do script localizado em `skills/script/scripts/script_check.py`, que valida a forma, sentenças, abertura, encerramento, números (contra a prova) e comprimento do texto. O fluxo de trabalho inclui a escrita de um rascunho, uma passagem obrigatória de humanização (usando a ferramenta Humanizer para tornar o texto mais natural) e a verificação final antes da entrega. O roteiro é então disponibilizado em um teleprompter web (crewcut prompter) para gravação. A skill é ativada por comandos como "write the script", "teleprompter text", "rewrite the script" e "make it sound natural", e não deve ser usada para criar títulos ou thumbnails. Para roteiros curtos, existe o modo `--short` da verificação e a skill `shorts`.

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

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que script faz?

O Escritor escreve o que o usuário diz no vídeo. Objetivo: o usuário lê uma vez e grava. Cada frase carrega ou prova a promessa do título e da thumbnail.

Antes de escrever

  1. O título e o texto da miniatura estão aprovados (brief/TITLE-vNNN.md). Sem título, sem roteiro.
  2. A prova está aprovada (brief/PROOF-vNNN.md). Nunca invente um número, uma experiência ou uma citação. Se algo estiver faltando, pergunte através do chat (crewcut say) antes de escrever; o roteiro não tem lacunas ou marcadores de posição.
  3. Leia voice.md (como o usuário fala, palavras a usar e a evitar), brand/rules/script.md e a duração em edit-style.json (length_minutes) com a taxa de fala em channel.json (script.words_per_minute).
  4. Leia os encerramentos dos três últimos roteiros, para que este veredito assuma uma nova forma.

Estrutura

Duas formas. Use o formulário de teste para uma ferramenta ou uma afirmação; use o formulário de história quando algo aconteceu (detalhes em references/forms.md).

  1. Abertura, de 2 a 6 frases. Os primeiros segundos carregam a promessa e seu número: a frase 1 nomeia a ferramenta ou tópico e sua afirmação. Sem saudação, sem pergunta, sem "neste vídeo". Os primeiros 30 segundos confirmam o clique: o espectador vê que recebeu o vídeo que o título e a miniatura prometeram. No máximo um loop em aberto, resolvido no final.
  2. O problema, em um caso que o espectador conhece. Explique uma ferramenta desconhecida na primeira vez que aparecer.
  3. O que faz, em imagens, apenas o que o espectador ainda não sabe.
  4. O próprio teste, com números reais, arredondados como as pessoas falam. Apenas testes do que a ferramenta foi feita para fazer.
  5. Uma linha de inscrição, logo após o primeiro resultado forte: o que o espectador ganha com o canal. Se nenhum fornecedor paga pelos testes, diga isso nessa linha. Nunca no início, nunca como um apelo no final.
  6. Pequenas histórias com apostas crescentes. Cada bloco entre a abertura e o veredito tem um objetivo, um obstáculo e uma solução; de bloco para bloco as apostas aumentam (mais dados, mais dinheiro, um teste mais difícil). O teste mais forte vem por último, antes do veredito; a abertura pode anunciá-lo, mas não revelá-lo.
  7. O lado crítico. O número do fornecedor contra a própria medição ou uma independente; os limites. Se a ferramenta não cumpre sua promessa, diga, e o título volta para a etapa do título.
  8. O veredito, em sua própria forma a cada vez: uma tarefa para o espectador, o único número que fica, o que significa para o próprio trabalho do usuário, um retorno à imagem da abertura. Não é uma pergunta fixa de encerramento.
  9. O final. Se channel.json tem uma oferta ou menção obrigatória (script.end_mentions), ela vem nas últimas frases, nas palavras do usuário. A última frase é o closing_line do canal quando houver uma.

Vídeos de comparação: no máximo dois blocos com a mesma construção em sequência; o terceiro muda de forma. Um novo gancho na metade. Cada afirmação uma vez. Custo e tempo de todos os candidatos uma vez, juntos na tela, não no final de cada bloco.

Palavras

  • As palavras do usuário de voice.md; nunca as palavras em sua lista de evitar.
  • Frases curtas: mediana de cerca de 10 a 12 palavras, nunca mais que script.sentence_max_words.
  • No máximo três nomes de produtos em uma frase; listas mais longas vão para a tela.
  • Fora: conhecimento básico que o público tem, detalhes que ninguém se importa (contagens de testes, interruptores internos), nomes de arquivos, comandos, tópicos secundários, pessoas privadas, por que um exemplo foi escolhido, custos que não fazem parte da promessa.
  • Sem tom de anúncio ou vendas: diga o que foi testado, não prometa nada ao espectador. Sem grandes "não isso, mas aquilo" na abertura.
  • Negócios se mostram através de exemplos, não ao abordar o negócio do espectador.

Formato de teleprompter

O usuário lê de um telefone ao lado da câmera.

  • Apenas texto falado acima de uma linha ---. Notas para a edição (cenas, clipes, de onde vem cada número) vão abaixo dela.
  • Um parágrafo é uma respiração: 1 a script.paragraph_max_sentences frases. Uma linha vazia é uma pausa curta.
  • Três linhas vazias separam partes: ali a edição pode cortar, ali o teleprompter vira a página, ali um clipe pode rodar.
  • Sem colchetes, notas de palco, títulos, capítulos, carimbos de tempo ou linha de título. Travessões apenas se o pacote os permitir.
  • Marque a palavra ou duas palavras-chave de um parágrafo em negrito. O modo de pontos do teleprompter as mostra em vez do texto completo, para um usuário que queira falar livremente.

Passos

  1. Preencha a estrutura com os números comprovados.
  2. Corte: cada frase carrega ou prova a promessa.
  3. Coloque na voz do usuário. Leia cada frase mentalmente: o usuário diria isso para a câmera?
  4. Escreva o rascunho em work/script-draft-vNNN.md com o próximo número livre; nunca sobrescreva uma versão.
  5. Passagem de humanização (veja abaixo). Escreva o resultado em brief/SCRIPT-vNNN.md (mesmo número), depois grave-o: crewcut humanize record --draft work/script-draft-vNNN.md --final brief/SCRIPT-vNNN.md --why "<os padrões que se aplicaram>".
  6. Verifique até 0 erros: python3 skills/script/scripts/script_check.py brief/SCRIPT-vNNN.md --title "<título>" --name "<ferramenta>" --proof brief/PROOF-vNNN.md. Leia cada aviso e dica; uma dica que você mantém ganha uma frase de razão abaixo de ---. Se você alterar o roteiro para passar na verificação, grave a passagem novamente: o cartão precisa do registro do arquivo exato.
  7. Cartão: crewcut card propose --episode <id> --step script --kind script --title "Roteiro, versão N" --file brief/SCRIPT-vNNN.md --body "<palavras>, cerca de <min> min, verificação: 0 erros", depois crewcut card wait. O cartão mostra "Humanizado" com o que mudou; sem o registro ele é recusado e diz o que executar.
  8. Após o sim: crewcut prompter <id> imprime o link do telefone e um código QR. Informe o usuário em uma mensagem: o link, quantas partes, aproximadamente quanto tempo. O teleprompter mostra apenas o texto acima de ---.

Passagem de humanização

Todo rascunho de roteiro passa pelo Humanizer (blader/humanizer, MIT) antes de o usuário vê-lo: tanto vídeos longos quanto Curtos. O Crewcut baixa sua versão mais recente na inicialização; no Claude Code é a skill humanizer:humanizer (execute como qualquer skill), com Codex seu texto está no seu prompt. crewcut skills status mostra a versão.

  • Modo "Incorporado", com a voz do usuário. Leia primeiro todos os arquivos em brand/voice/: as palavras faladas reais do usuário de seus vídeos. Forneça-os ao Humanizer como amostra de voz. Sem amostras: modo simples; o cartão informa isso.
  • O que procurar mais: contrastes "não X, mas Y"; linhas de encerramento que não acrescentam nada novo; ditados que soam profundos; uma preparação encenada antes do ponto ("a questão é"); listas de três; significado inflado e linguagem publicitária.
  • O que permanece: as próprias palavras e expressões do usuário (aquelas em brand/voice/ e voice.md) mesmo quando o Humanizer as suavizaria; cada número, nome, afirmação e a promessa do título. A passagem muda como soa, nunca o que diz.
  • O que está fora do escopo: fazer o texto passar por detectores de IA. O Humanizer edita para pessoas, e nós também.

O que a verificação não pode ver

Se um exemplo se torna muito amplo, se uma parte sai do fio condutor, se um teste se encaixa na promessa, se a voz soa como o usuário. Isso é trabalho de leitura nos passos 2 e 3.

Planejado

  • Folha de sugestões e duas tomadas por parte (primeira livre de uma folha de sugestões, depois do roteiro; a edição pega a melhor tomada): formato em references/forms.md; o verificador e a mixagem de tomadas (zettel.py no estúdio) ainda não foram portados.
  • Roteiro contra gravação: comparar o roteiro aprovado com a transcrição para aprender as palavras reais do usuário (essas transcrições podem se tornar novas amostras de voz).
  • Uma lista de verificação de frases por idioma (palavras de preenchimento, frases de venda) como dados em voice.md.

Fontes

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.

Habilidades Relacionadas