Communitygithub.com

tianbester-ZA/script

Escreve roteiros para vídeos pagos em redes sociais e reels de 15 a 60 segundos (UGC, founder, talking head, esquetes) e os empacota no formato de pacote de gravação do Butcherbird, verificando cada gancho, promessa, prova e oferta contra 17 livros de publicidade por meio de pesquisa de livros e, em seguida, executando uma passagem de crítica separada.

O que é script?

Esta skill, `tianbester-ZA/script`, é uma ferramenta de IA especializada em criar roteiros de alto desempenho para anúncios pagos e conteúdo orgânico em redes sociais, com duração de 15 a 60 segundos, incluindo formatos como UGC, vídeos de fundador, depoimentos e esquetes. Ela foi projetada para resolver a tendência de modelos de IA gerarem roteiros 'polidos' e seguros, que são limpos mas sem impacto. A skill segue um processo rigoroso em 8 etapas: começa com a compreensão profunda do cliente e do público, diagnostica o problema de marketing, pesquisa 17 livros de publicidade para embasar cada decisão criativa, gera múltiplas opções de ganchos e rascunhos, verifica a consistência do pacote, submete o rascunho a um agente crítico independente, reescreve com base no feedback e, finalmente, constrói um pacote de gravação em PDF, com um anúncio por página. O resultado é um pacote de anúncios direcionável, com uma única oferta por anúncio, que para um estranho em dois segundos mesmo sem som, e que é apoiado por uma folha de raciocínio que cita a passagem do livro para cada decisão. É ideal para substituir roteiros fracos, criar novos conceitos a partir de uma oferta e uma vibe, ou reestruturar um anúncio cansado, mas não deve ser usado para anúncios estáticos, e-mails ou landing pages.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tianbester-ZA/butcherbird-skills/tree/main/plugins/bb/skills/script

Perguntar na sua IA favorita

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

Documentação

/bb:script

Objetivo

Um pacote de gravação que a equipe possa filmar em uma tarde. Cada anúncio para um estranho em dois segundos com o som desligado, dá a uma pessoa um motivo para comprar e termina com uma oferta que ela possa aproveitar. Por trás disso, uma folha de raciocínio nomeia a passagem do livro para cada gancho, promessa e prova.

Comece aqui: leia, reformule, pergunte uma vez

A pessoa que está executando isso detém o contexto, e o que ela disser aqui é o que torna o trabalho bom. Um anúncio nosso falhou porque nada foi perguntado; um reel funcionou porque alguém deu um contexto real.

Leia primeiro, não pergunte: os vencedores do cliente, personas, avaliações e anúncios anteriores; produto ao vivo, preço e oferta; o que foi dito no briefing.

Reformule: comprador, ângulo, estágio, oferta, conforme você os lê a partir das evidências. Preencha o que você sabe, para que eles confirmem em vez de redigitar.

Pergunte apenas o que está faltando, em uma rodada curta (AskUserQuestion quando você tiver, caso contrário na mensagem). Geralmente duas ou três:

  1. Quem este anúncio deve mover, o que eles devem imaginar para si mesmos e o que devem fazer imediatamente após assistir?
  2. Qual produto exato, oferta, preço, motivo para agir e prova podemos mostrar hoje? O que realmente aconteceu com a pessoa que está falando?
  3. Quem está falando, como devem soar e o que podemos realmente filmar: câmera, pessoas, local, adereços, tempo?

Em seguida, proponha onde se encaixa, para um sim ou uma mudança: comprador × ângulo × estágio de conscientização, o modo do roteiro (história do fundador, resposta a comentário real, demonstração, liderado por problema, comparação justa, desafio de campo ou entretenimento, oferta direta) e o formato.

Coloque as respostas em job/brief.md, depois trabalhe até o fim sem parar novamente. Se eles já deram tudo, ou disseram apenas vá em frente, não pergunte. Se ninguém puder responder (uma execução sem cabeça), diga o que você teria perguntado e assuma a leitura sensata.

O gosto pertence ao trabalho

Escreva o trabalho na primeira linha de job/brief.md: anúncio pago, reel orgânico, ou o que a rodada inicial definiu. O que alguém gostou em um vídeo não se aplica a outro. Um reel orgânico e um anúncio são trabalhos diferentes: o anúncio tem a intenção de vender. Portanto, um anúncio é julgado por para quem é, os pontos de venda do produto, a prova e um motivo para comprar, não pelas piadas ou pela sensação de uma peça orgânica. Uma piada ganha seu lugar em um anúncio apenas se carregar a venda.

Por que isso existe

Deixado sozinho, Claude escreve anúncios educados: uma pessoa para a câmera, um gancho falado suave que precisa que você conheça a estrela, uma pequena piada, a oferta dita duas vezes, o mesmo fechamento toda vez. Limpo, filmável e monótono. Os modelos tendem à escolha segura e comum, e uma lista de regras não os traz de volta.

O que funciona: encontrar o apelo antes das palavras, fazer muitos ganchos antes de escolher, ter a nota do livro à sua frente e deixar um crítico que nunca viu seu raciocínio julgar o rascunho. Os livros são perguntas e passagens, nunca vozes. "Escreva como Schwartz" não faz nada. "Este espectador está frio, então a primeira linha o descreve, em vez do produto?" com a passagem por trás, faz.

Como é um bom resultado

  • Cinco anúncios que não compartilham a mesma forma. Leia a ordem de exibição e você não consegue prever o anúncio 4 a partir do anúncio 1.
  • Um primeiro quadro e uma linha de texto que um estranho entende no mudo, com poucas palavras. A câmera pode ser um personagem e a piada final pode ser um olhar. Nem toda ideia é um talking head, e nem toda ideia termina com alguém caindo em uma piscina.
  • Rápido e claro sobre para quem é e por que eles comprariam, e cada anúncio termina com uma oferta. Esquetes são bem-vindos quando o briefing pede diversão, e ainda devem vender: a piada é o ponto de venda, e recontá-la precisa do produto.
  • Direcionável: "Faça isso. Faça isso. Diga isso." A configuração mais simples que carrega a ideia, geralmente um lugar e o menor número de pessoas.
  • Uma oferta por anúncio, dita uma vez, no fechamento, exatamente, em doze palavras ou menos, redigida em sua forma verdadeira mais forte.
  • Números exatos e detalhes nomeados em vez de adjetivos, cada um rastreado até seu dono.
  • Fala com uma pessoa e muda uma crença que ela tem. Um produto passeando por belas cenas é uma vitrine, por mais bonita que seja, e falha.
  • Um pacote que se parece exatamente com o formato enviado, sem citações, sem perguntas em aberto e nada marcado como não confirmado.

Comandos

Os arquivos de referência escrevem estes de forma abreviada. O estado do shell não persiste entre comandos, portanto, sempre use a forma completa e dê a forma completa a um agente crítico também.

  • scripts/... significa ${CLAUDE_SKILL_DIR}/scripts/.... references/... significa ${CLAUDE_SKILL_DIR}/references/....
  • search.py significa python3 "${CLAUDE_PLUGIN_ROOT}/skills/books/scripts/search.py".
  • Cartões de livros: ${CLAUDE_PLUGIN_ROOT}/skills/books/cards/.

O caminho

Trabalhe em <cliente>-scripts/<aaaa-mm-dd>-<slug>/ na pasta em que a pessoa está, ou na pasta que o briefing nomeia (job/). Cada etapa escreve algo, para que uma sessão reiniciada continue do último arquivo.

0. Leia, o cliente primeiro. A rodada de abertura acima, feita corretamente: os próprios vencedores do cliente e seus números, suas personas e as palavras de seus clientes (avaliações, comentários de anúncios), onde quer que suas notas apontem. "Nenhum arquivado" significa que você ainda não olhou. Em seguida, quaisquer notas do cliente ou habilidade de perfil, a própria pasta de vencedores do cliente (apenas aquele cliente, veja examples/README.md), lessons.md, o briefing. Verifique novamente preços, ofertas e datas em suas fontes. Escreva job/brief.md: fatos e ofertas com fonte e data, quem está na câmera, o que só esta marca tem, as ideias do próprio cliente uma por linha, as respostas da rodada de abertura.

1. Diagnostique. Carregue references/diagnose.md. Comece com uma pessoa real: um nome para seu tipo, seu dia, o que ela usa agora, o que ela diria, por que ela e não as outras personas, com as evidências. Em seguida, estabeleça o apelo, o que eles fazem agora, o quão conscientes estão, quantas vezes ouviram, no que não acreditam, por que a oferta existe e o que só esta marca tem. Escreva reasoning.md §1, um bloco por slot.

2. Pesquise os livros para este trabalho. Carregue references/search.md. Não comece pela memória do que os livros dizem: execute seis a dez pesquisas sobre os problemas reais deste produto, leia as notas com --show, mantenha oito a doze que sejam relevantes para este briefing. Escreva reasoning.md §2: id, uma linha, qual slot.

3. Ganchos. Carregue references/hooks.md. Seis a oito por anúncio em pelo menos quatro tipos, incluindo um simples e pelo menos dois estranhos que você hesitaria em mostrar ao cliente. Mantenha três: um seguro, um estranho, um que não diga a oferta. Escreva reasoning.md §3. Faça as opções mesmo quando ninguém estiver lá para vê-las: escolha e deixe as descartadas na folha.

4. Rascunho. Carregue references/body-and-close.md, references/offer-and-proof.md e references/pack-format.md. Escreva job/pack-draft.md. Escreva reasoning.md §4: por anúncio, uma linha cada para gancho, promessa, prova, corpo e fechamento, cada um com sua passagem.

5. Verifique.

python3 "${CLAUDE_SKILL_DIR}/scripts/check_pack.py" job/pack-draft.md --event "Black Friday"
python3 "${CLAUDE_SKILL_DIR}/scripts/cite_check.py" job/reasoning.md

Corrija cada linha vermelha. Linhas âmbar são questões de julgamento. Salve a saída em job/checks.txt.

6. Crítico. Inicie um novo agente no modelo mais forte disponível com pack-draft.md, brief.md, references/critic.md, o comando completo search.py (e, para uma edição, as folhas de gravação). Não reasoning.md, não este chat: ele julga o anúncio contra o trabalho no briefing, não a desculpa. Suas perguntas nomeiam passagens reais e ele lê suas notas. Ele retorna notas, nunca uma reescrita. Salve como job/critic.md.

7. Reescreva. Leia a nota por trás de cada passagem que o crítico citar antes de agir sobre ela: alguns ids acabam sendo sobre outra coisa, e uma nota ainda pode estar correta em sua própria lógica. Onde o briefing vencer, discorde por escrito em reasoning.md §5. Repita a etapa 5. Uma rodada, no máximo duas. O resultado é job/pack.md.

8. Empacote.

python3 "${CLAUDE_SKILL_DIR}/scripts/build_pack.py" job/pack.md --pdf

Abra o PDF e olhe cada página: nada cortado, um anúncio por página. Leia quaisquer linhas warning:. Na resposta, dê uma linha por anúncio e uma frase nomeando os livros uma vez. Se o cliente tiver um log, adicione uma linha datada.

O que está resolvido está resolvido

Fatos que a pessoa resolveu estão resolvidos. Ninguém quer um pacote que liste coisas como não confirmadas, ou uma página de pequenas perguntas. Então não faça isso: use a leitura sensata, escreva em reasoning.md §0 com uma linha do porquê, e siga em frente. Coloque o que eles confirmaram na linha settled: do pacote, que o verificador respeita. Se um número realmente não tem dono, escreva o anúncio sem ele e registre isso.

Apenas o que mudaria uma decisão ou um cliente é levantado, como uma linha simples na resposta. Um número que você não pode rastrear nunca é inventado e nunca aparece como uma pergunta também.

Editando filmagens que já existem

Às vezes o trabalho é palavras para filmagens em mãos, não uma gravação. Mesmo caminho, três diferenças. A etapa 0 começa a partir da filmagem: liste os momentos utilizáveis por clipe e tempo, já que o roteiro só pode prometer o que foi filmado. A etapa 1 adiciona uma verificação de filmagem: para cada afirmação, nomeie o momento do clipe que a mostra, e reescreva ou descarte uma afirmação sem tomada. Na página, coloque mode: edit no front matter: as linhas Say seguram palavras na tela, o fechamento é texto na tela, a seção de filme é ## The footage. Entregue o pacote para /bb:edit.

Limites rígidos

  • Um cliente por trabalho. Nada de outro cliente vai para o briefing, o pacote ou a folha, e nenhuma informação de cliente vai para esta skill.
  • Sem números, prazos, estoques ou avaliações inventados. A urgência é apenas o que é verdadeiro e tem um motivo.
  • O texto do livro permanece de fora. Diga o que um livro ensina em suas próprias palavras e cite o id.
  • Nada vai para um cliente, é publicado ou gasta dinheiro a partir desta skill sem o sim da pessoa. O pacote vai para a pessoa que está executando isso; ela o envia.

Know-how

Palavras por segundo. 2,5 palavras faladas por segundo: 15 s são cerca de 35 palavras, 20 s cerca de 50, 30 s cerca de 75, 60 s cerca de 150. As ações também levam tempo.

Os livros não são sobre reels. Eles são impressos, mala direta, TV e estudos de laboratório. Trate os números como o que moveu as pessoas naquela época. Os de Hormozi são suas próprias alegações; muitos dos de Cialdini são favores, não compras. Nada neles testa um feed no mudo. Gramática no mudo, a câmera como um personagem e piadas finais vêm de assistir a reels reais, então é aí que se deve olhar: as próprias referências do cliente e o que a pessoa enviou.

Onde os livros discordam. Cada referência termina com as discordâncias e para que lado pendemos para um vídeo de 15 a 60 segundos. Nomeie a inclinação na folha quando ela decidir um anúncio.

Um voto é um teste de opinião. Críticos e juízes preferem o inteligente; testes divididos frequentemente não (caples-0221, caples-0279). Portanto, um gancho simples é filmado como outra opção mesmo quando o crítico não fica impressionado, e números ao vivo resolvem isso.

Gancho e retenção. Taxa de gancho = reproduções de 3 segundos ÷ impressões. Taxa de retenção = ThruPlays ÷ reproduções de 3 segundos. Gancho abaixo de cerca de 20%: recorte apenas a abertura. Retenção abaixo de cerca de 40%: recorte o meio. Ambos saudáveis e sem compras: a oferta ou o fechamento, não a edição.

Carregue estes quando

ReferênciaQuando
references/diagnose.mdEtapa 1, e sempre que um roteiro parecer sem graça e você não souber dizer por quê
references/search.mdEtapa 2, ou quando uma pesquisa voltar vazia
references/hooks.mdEtapa 3, e para qualquer trabalho de "re-ganchar este anúncio"
references/body-and-close.mdEtapa 4
references/offer-and-proof.mdEtapa 1 para a lacuna de crença e o motivo da oferta; etapa 4
references/pack-format.mdEtapa 4 e etapa 8
references/critic.mdApenas o agente crítico (etapa 6)
examples/README.mdEtapa 0, para encontrar os vencedores de um cliente
evals/judge.mdApenas para testes cegos entre dois pacotes

Lições

lessons.md contém marcadores datados de resultados reais: o anúncio, o número com sua data, a passagem por trás do elemento, o que foi tentado. Leia os últimos cinco na etapa 0; o crítico verifica o rascunho contra eles. Esta pasta é substituída a cada atualização, portanto, as lições e vencedores de um cliente vão para a pasta desse cliente, e uma lição para todos vai através do repositório (CONTRIBUTING.md).

Individual skills in this repo

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

Habilidades Relacionadas