Communitygithub.com

construtor-de-voz

Transforma amostras de escrita de uma pessoa em um guia de voz reproduzível, permitindo que outros criem conteúdo que soe exatamente como ela.

O que é construtor-de-voz?

Voice Builder é uma skill especializada projetada para ajudar agentes de IA, como Claude Code, Cursor ou Codex, a extrair e sistematizar a voz única de um escritor a partir de amostras reais de seu trabalho. Ao invés de confiar em adjetivos vagos como 'autêntico' ou 'dinâmico', a skill aplica uma análise rigorosa baseada em evidências em seis camadas (léxico, sintaxe, retórica, estrutura, postura e espaço negativo) para criar um arquivo `voice.md` operacional. Este guia contém regras específicas e reproduzíveis que permitem que qualquer skill a jusante ou escritor humano produza conteúdo indistinguível da fonte original. O processo inclui a coleta criteriosa de amostras (de preferência com transcrições de fala), a destilação de uma 'impressão digital' de 5 a 7 assinaturas mais marcantes, e uma etapa obrigatória de validação onde o guia é testado contra a escrita real. A skill lida explicitamente com casos extremos, como amostras insuficientes, vozes inconsistentes ou aspirações de mudança de estilo, sempre priorizando a honestidade sobre a confiança na análise. Ela se integra perfeitamente com skills complementares como `brand-profile` e `writing-style-and-tone` para formar um ecossistema completo de criação de conteúdo consistente e autêntico.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/social-media-skills/skills/tree/main/skills/voice-builder

Perguntar na sua IA favorita

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

Documentação

Voice Builder (Construtor de Voz)

Esta skill transforma a escrita real de uma pessoa em uma voz reproduzível — um voice.md que qualquer skill downstream (ou humano) pode usar para escrever e produzir posts indistinguíveis da fonte original.

O princípio central: a voz é extraída da evidência, não descrita com adjetivos. "Sucinto e autêntico" não é algo que se possa escrever — não diz nada a um escritor. "Abre com uma provocação de uma linha, escreve em frases curtas com uma longa para contraste, usa travessões, nunca usa pontos de exclamação, termina com uma pergunta" é reproduzível. Seu trabalho é converter a escrita de alguém em regras específicas.

Quando usar esta skill

  • Após brand-profile, para aprofundar a voz quando o usuário tiver amostras de escrita.
  • Quando o conteúdo continua saindo genérico, artificial ou "não é a minha cara".
  • Para ghostwriting em escala — capture a voz uma vez, escreva nela para sempre.

Quando NÃO usar: se não houver amostras utilizáveis, não invente uma voz. Encaminhe para a entrevista de voz do brand-profile (dimensões + léxico + a linha "nós soamos ___, nunca ___") e volte quando houver amostras. Uma voz fabricada é pior do que uma entrevista honesta.

Passo 0 — Leia brand-profile primeiro

Carregue brand-profile.md para obter identidade, público e diretrizes. voice-builder produz o voice.md que fica ao lado dele. Se um voice.md já existir e estiver atualizado, carregue-o, resuma-o de volta e pule para o que o usuário realmente precisa.

Passo 1 — Reúna as amostras certas

Qualidade supera quantidade. As melhores amostras são inequivocamente da pessoa — textos dos quais ela se orgulha, em seu registro natural, que ela realmente escreveu (não editados por comitê, não escritos por ghostwriter, não gerados por IA). Busque de 5 a 10 amostras substanciais; 3 é o mínimo. Transcrições de fala são ouro — elas capturam o ritmo natural antes que a autoedição o achate. Veja references/samples-guide.md para saber o que coletar e o que excluir.

Se as amostras forem escassas ou inconsistentes, diga isso claramente e prossiga com menor confiança, em vez de exagerar. A honestidade sobre a confiança faz parte da entrega.

Passo 2 — Analise em seis camadas (com evidências)

Não faça associações livres sobre "tom". Siga o framework em references/analysis-framework.md, camada por camada:

  1. Léxico — escolha de palavras, frases características, contrações, registro, palavras proibidas por hábito.
  2. Sintaxe — comprimento e variação das frases, aberturas, fragmentos, voz ativa/passiva, ritmo.
  3. Retórica — perguntas, discurso direto, repetição, analogia, contraste, humor, a "virada".
  4. Estrutura — como abrem, constroem e fecham; parágrafos; formatação.
  5. Postura — distância do leitor, postura de autoridade, confiança, registro emocional.
  6. Espaço negativo — o que eles nunca fazem. Frequentemente a camada mais definidora.

Para cada padrão que você nomear, cite a evidência — cite a amostra. Um guia de voz construído sobre afirmações se perde; um construído sobre citações se mantém.

Passo 3 — Destile a impressão digital da voz

A partir da análise, extraia as 5 a 7 assinaturas mais distintivas e reproduzíveis — as poucas coisas que, feitas corretamente, tornam a escrita reconhecível como sendo da pessoa. Este é o coração do voice.md. Combine-o com o espaço negativo (os "nunca" duros). Se você acertar apenas a impressão digital, um leitor já deve acreditar que é a pessoa.

Passo 4 — Escreva voice.md

Use references/voice-template.md. Torne-o operacional, não um ensaio de personalidade: regras que um escritor possa seguir, um mapa de tom de como a voz se flexiona por contexto, e 3 a 5 reescritas de faça/não faça (uma frase genérica → a mesma coisa nesta voz). Mantenha trechos reais de amostras como âncoras de calibração.

Passo 5 — Valide com o teste de voz (não pule)

Um voice.md que não foi testado é uma hipótese. Execute o loop em references/validation.md:

  1. Gere um post novo sobre um tópico novo usando apenas voice.md.
  2. Coloque-o ao lado de uma amostra real. O usuário conseguiria dizer qual é qual?
  3. Pontue-o contra as assinaturas da impressão digital — quais acertou, quais errou?
  4. Corrija os erros, refine o voice.md e repita uma ou duas vezes.

Mostre ao usuário o post de teste e o resultado. A voz não está pronta até passar.

O que é "excelente" (autoverificação antes de finalizar)

  • Um escritor que nunca conheceu esta pessoa poderia escrever um post na voz a partir apenas do voice.md.
  • Toda afirmação cita uma amostra — sem adjetivos sem suporte.
  • A impressão digital é específica o suficiente para ser falseável (você poderia apontar para um post e dizer "isso não é ele/ela, porque…").
  • O espaço negativo é capturado, não apenas os traços positivos.
  • A voz passou no teste de voz, e você mostrou a prova.

Se algum destes itens estiver faltando, você não terminou.

Casos extremos — trate explicitamente

  • Amostras escassas (1–2 textos curtos): capture o que é observável, marque o guia como baixa confiança, nomeie quais camadas você não conseguiu determinar e complemente com a entrevista do brand-profile. Não finja certeza.
  • Amostras inconsistentes (deriva de voz): não as transforme em uma média sem graça. Sinalize a inconsistência e pergunte quais amostras representam a voz alvo; ancore-se nelas.
  • Voz aspiracional (eles querem soar diferente do que são atualmente): separe a voz atual da alvo. Colete amostras de quem eles querem soar, rotule-as como aspiracionais e faça uma mescla transparente para que o usuário saiba o que está sendo emprestado.
  • Vozes múltiplas (empresa vs. fundador; vários criadores): um voice.md por voz, nomeado. Nunca misture vozes — isso produz uma pessoa que não existe em lugar nenhum.
  • Amostras fortemente editadas / escritas por ghostwriter / geradas por IA: exclua-as; elas não são a voz da pessoa. Diga o motivo.
  • Fala vs. escrita: transcrições revelam ritmo natural, mas precisam de regras de limpeza (muletas, falsos começos). Capture o ritmo, anote a limpeza.
  • Multilíngue: analise por idioma; a voz raramente se mapeia 1:1 entre idiomas.

Skills relacionadas

  • brand-profile — leia primeiro; fornece identidade, público e diretrizes.
  • writing-style-and-tone — aplica o voice.md por peça e por momento (mapa de tom, passagens de edição, varredura de marcas de IA). Esta skill escreve a constituição; aquela a governa.
  • Toda skill de conteúdo (caption-writer, reels-script, thread-writer, linkedin-post-writer, …) lê o voice.md resultante.
  • audience-research, content-pillars — skills complementares de fundação.

Referências

  • references/samples-guide.md — como obter e avaliar as amostras de escrita certas.
  • references/analysis-framework.md — o framework de seis camadas para desconstruir a voz.
  • references/voice-template.md — a estrutura exata do voice.md a ser produzida.
  • references/validation.md — o teste de voz: gerar, comparar, pontuar, refinar.
  • references/examples.md — dois exemplos práticos contrastantes, do início ao fim.

Individual skills in this repo

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

Habilidades Relacionadas