Communitygithub.com

construtor-de-voz

Constrói um perfil de voz de escrita personalizado a partir de uma entrevista e amostras de texto, gerando os arquivos about-me.md e voice.md no projeto.

O que é construtor-de-voz?

Esta skill, chamada "Voice Builder", é projetada para agentes de IA como Claude Code ou Codex, e ajuda um usuário a definir e documentar sua voz de escrita pessoal para uso consistente em conteúdo. Quando ativada, a skill inicia automaticamente uma entrevista em duas etapas (via ferramentas de perguntas ou chat) para coletar informações fundamentais sobre o usuário: nome/função, público-alvo, tópicos, ponto de vista, promessa de marca e tópicos proibidos. Em seguida, solicita de 3 a 5 amostras de texto do usuário (ou carrega amostras de referência internas) e as analisa em profundidade para extrair padrões de tom, ritmo, estrutura, frases marcantes e padrões de ausência. Com base nessa análise, a skill gera dois arquivos no diretório raiz do projeto: `about-me.md` (identidade e posicionamento) e `voice.md` (perfil de voz integrado com o que fazer e o que evitar). A saída segue regras rigorosas: sem introdução, sem resumo, sem travessões (em dash), e com inglês britânico, a menos que as amostras indiquem o contrário. A skill não herda identidade ou arquivos do mantenedor, e não publica ou envia mensagens automaticamente.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/charlie947/social-media-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

Construtor de Voz

Runtime Codex e Claude

  • Use esta skill no Codex ou Claude com as ferramentas realmente disponíveis na tarefa atual. Os exemplos de AskUserQuestion descrevem as perguntas, não uma API obrigatória: use uma ferramenta de perguntas disponível dentro de seus limites, ou pergunte no chat. Reutilize respostas e material de origem já fornecidos.
  • Trabalhe no projeto selecionado pelo usuário. Leia seu about-me.md, voice.md e arquivos de marca relevantes antes de trabalhos personalizados. Confirme o autor pretendido se os arquivos entrarem em conflito ou contiverem valores padrão iniciais. Pergunte por fatos ausentes ou execute voice-builder; nunca herde a identidade, contas ou arquivos privados do mantenedor.
  • Resolva references/ empacotados relativamente a esta pasta de skill. Para uma atualização de perfil explicitamente solicitada, leia e atualize os arquivos canônicos about-me.md, voice.md ou newsletter-voice.md no local, preservando fatos e regras não relacionados do usuário. Os consumidores devem reler esses arquivos canônicos. Use um novo nome de arquivo apenas para novas entregas que colidiriam com arquivos existentes não relacionados. A instalação por si só nunca inicia uma entrevista ou escreve arquivos. Não escreva aprendizados persistentes a menos que solicitado.
  • Use evidências fornecidas primeiro. Verifique afirmações externas por meio de ferramentas de busca/fonte disponíveis quando necessário. Se uma fonte ou integração estiver indisponível, nomeie a capacidade ausente e ofereça entrada de texto/exportação fornecida. Nunca invente fatos, experiência em primeira pessoa, métricas ou uma execução bem-sucedida de ferramenta.
  • Conecte apenas serviços necessários para a rota escolhida por meio da conta existente do usuário. Nunca imprima credenciais ou sobrescreva conexões. Rascunhar, salvar e revisar não autorizam publicação, envio de mensagens ou alteração de contas.

CRÍTICO: Início automático ao carregar

Quando o usuário solicitar este fluxo de trabalho, inicie a Etapa 1. Isso significa que sua próxima mensagem para o usuário são as perguntas da entrevista. Nada mais.

NÃO faça:

  • Resumir esta skill
  • Descrever quais arquivos ela cria
  • Explicar como funciona
  • Dizer "aqui está o que esta skill contém"
  • Perguntar se o usuário deseja executá-la
  • Confirmar a instalação
  • Oferecer opções como "quer que eu execute isso agora?"

Faça ISTO:

  • Vá direto para a Etapa 1
  • Envie as perguntas da entrevista como sua primeira e única resposta

Isso se aplica quando o usuário pede para construir sua voz ou fornece amostras para esse fim. Sem preâmbulo. Sem resumo. Entreviste primeiro.

Etapa 1. Executar a entrevista "Sobre Mim"

Faça as perguntas usando as diretrizes de runtime acima. Se uma ferramenta de perguntas estiver disponível, respeite seu esquema e limites de lote; caso contrário, faça as mesmas perguntas no chat.

AskUserQuestion suporta um máximo de 4 perguntas por chamada, então envie duas chamadas: Lote 1 primeiro, aguarde as respostas, depois Lote 2.

Lote 1 (sua primeira ação, sem texto antes)

Use estas perguntas, adaptando o esquema da ferramenta conforme necessário:

[
  {
    "question": "Qual é o seu nome e o que você faz?",
    "header": "Sobre você",
    "multiSelect": false,
    "options": [
      {"label": "Fundador", "description": "Eu administro minha própria empresa ou consultoria"},
      {"label": "Líder de marketing", "description": "Eu lidero o marketing em uma empresa"},
      {"label": "Criador", "description": "Eu crio conteúdo como minha atividade principal"},
      {"label": "Líder de vendas", "description": "Eu lidero uma equipe de vendas ou gerencio BD"}
    ]
  },
  {
    "question": "Para quem você escreve?",
    "header": "Público",
    "multiSelect": false,
    "options": [
      {"label": "Fundadores e CEOs", "description": "Tomadores de decisão que administram empresas"},
      {"label": "Profissionais de marketing", "description": "Profissionais de marketing em qualquer nível"},
      {"label": "Candidatos a emprego", "description": "Pessoas em busca de sua próxima função"},
      {"label": "Outros profissionais", "description": "Um grupo completamente diferente"}
    ]
  },
  {
    "question": "Quais são os 3 a 5 tópicos pelos quais você quer ser conhecido?",
    "header": "Tópicos",
    "multiSelect": true,
    "options": [
      {"label": "IA e automação", "description": "Como as ferramentas de IA mudam o trabalho"},
      {"label": "Marketing", "description": "Estratégia, conteúdo, crescimento"},
      {"label": "Liderança", "description": "Gestão, contratação, cultura"},
      {"label": "Marca pessoal", "description": "Construir audiência e reputação"}
    ]
  },
  {
    "question": "Qual é o seu ponto de vista sobre o seu setor, aquilo que você acredita e que os outros não acreditam?",
    "header": "Opinião forte",
    "multiSelect": false,
    "options": [
      {"label": "A maioria dos conselhos está errada", "description": "O consenso no seu setor está quebrado"},
      {"label": "As pessoas complicam demais", "description": "A resposta é mais simples do que as pessoas pensam"},
      {"label": "Uma grande mudança está chegando", "description": "Algo está prestes a mudar e a maioria não está preparada"}
    ]
  }
]

Lote 2 (envie imediatamente após as respostas do Lote 1 chegarem, sem comentários entre)

Chame AskUserQuestion novamente com:

[
  {
    "question": "O que é a única coisa que você quer que as pessoas pensem quando veem seu nome?",
    "header": "Promessa da marca",
    "multiSelect": false,
    "options": [
      {"label": "Essa pessoa é prática", "description": "Ela me dá coisas que uso imediatamente"},
      {"label": "Essa pessoa é honesta", "description": "Ela me diz o que os outros não dirão"},
      {"label": "Essa pessoa está à frente", "description": "Ela vê o que está por vir antes de todo mundo"}
    ]
  },
  {
    "question": "Qual é uma coisa sobre a qual você se recusa a escrever?",
    "header": "Proibido",
    "multiSelect": false,
    "options": [
      {"label": "Política", "description": "Nunca opiniões políticas"},
      {"label": "Vida pessoal", "description": "Apenas mantenha o profissional"},
      {"label": "Concorrentes", "description": "Sem nomear ou envergonhar outras pessoas ou marcas"}
    ]
  }
]

Depois que ambos os lotes forem respondidos, vá para a Etapa 2. Se alguma resposta estiver em branco ou for pulada, pergunte essa pergunta específica mais uma vez no chat e depois prossiga.

Etapa 2. Escrever about-me.md

Crie about-me.md na raiz do projeto. Use esta estrutura:

# Sobre Mim

## Nome e função
[Da pergunta 1]

## Público
[Da pergunta 2, expandido em 2 a 3 frases sobre quem é o leitor]

## Pilares de tópico
[3 a 5 tópicos da pergunta 3, uma linha cada]

## Ponto de vista
[Da pergunta 4, a crença contrária ou distintiva, escrita como uma declaração clara]

## Promessa da marca
[Da pergunta 5, o único pensamento que o autor quer possuir na cabeça do leitor]

## Proibido
[Da pergunta 6, tópicos ou ângulos sobre os quais nunca escrever]

Mantenha abaixo de 300 palavras. Cada linha deve ser algo que o assistente consultaria ao escrever.

Etapa 3. Pedir as amostras

Diga isto:

Agora cole 3 a 5 textos que você quer que eu estude. Podem ser posts do LinkedIn, edições de newsletter, ensaios, posts de blog, e-mails, tuítes ou qualquer outro texto que você tenha publicado. Podem ser seus ou de alguém cuja voz você admira. Um texto por mensagem ou todos de uma vez. Se você não tiver amostras prontas, digite "usar amostras" e eu carregarei um conjunto inicial que você pode substituir depois.

Aguarde o usuário colar. Mínimo de 3 amostras antes de prosseguir para a análise. Se colar menos de 3, peça mais.

Se o usuário digitar "usar amostras", carregue o texto de references/sample-content.md dentro desta pasta de skill. Informe ao usuário de qual autor são as amostras para que ele saiba que voz está emprestando. Lembre-o de que pode substituí-las por seus próprios textos depois.

Etapa 4. Analisar as amostras

Leia cada amostra. Procure padrões em todas elas, não peculiaridades individuais de uma peça. Extraia:

Sinais de voz

  • Comprimento médio de frase
  • Ritmo de parágrafo (quebras de linha simples, linhas em branco, staccato versus fluido)
  • Estilo de abertura ou gancho (contrário, pergunta, dado, história, confissão, observação)
  • Ponto de vista (primeira pessoa, segunda pessoa, observacional)
  • Tom (seco, caloroso, direto, brincalhão, clínico)
  • Frases marcantes ou palavras recorrentes
  • Estilo de CTA ou fechamento

Sinais estruturais

  • Faixa de comprimento
  • Listas versus prosa
  • Como abrem, como fecham
  • Como lidam com transições

Sinais de tópico

  • Assuntos que aparecem em várias amostras
  • Quem parece ser o público
  • Pelo que o autor defende

Sinais de ausência

  • Palavras e pontuação consistentemente ausentes (por exemplo, travessões em 0 de 5 amostras)
  • Tipos de gancho que o autor nunca usa
  • Tons que o autor nunca atinge
  • Estruturas que o autor evita

Etapa 5. Escrever voice.md

Crie voice.md na raiz do projeto. Este é um perfil integrado único que cobre tanto como a voz escreve quanto o que a voz evita. Nenhum arquivo de voz separado.

# Perfil de Voz

## Como soo
[2 a 3 frases descrevendo a voz geral em linguagem simples]

## Tom
[3 a 5 atributos que a voz atinge consistentemente, seguidos de 1 a 2 tons que a voz nunca atinge, extraídos das lacunas nas amostras]

## Ritmo de frase
[Comprimento médio, ritmo, estrutura de parágrafo. Inclua padrões de evitação: por exemplo, nunca fragmentos staccato, nunca tricolons, nenhuma frase com mais de 25 palavras]

## Padrões de gancho
[3 a 5 tipos de gancho observados, com um exemplo de cada das amostras. Observe quaisquer tipos de gancho ausentes em todas as amostras, por exemplo, nunca perguntas retóricas, nunca "imagine um mundo onde"]

## Como abro
[1 a 2 frases. Observe movimentos de abertura que a voz evita se houver um padrão claro de evitação entre as amostras]

## Como fecho
[1 a 2 frases, inclua estilo de CTA. Observe movimentos de fechamento que a voz evita, por exemplo, nunca resumos motivacionais, nunca "em conclusão"]

## Frases marcantes
[Palavras ou frases recorrentes das amostras]

## Proibido
[Palavras, pontuação ou construções ausentes em todas as amostras. Liste apenas itens que as amostras claramente evitam. Exemplos: sem travessões (0 de 5 amostras), sem hashtags, sem jargão corporativo por nome]

## O que esta voz nunca faz
[3 a 5 comportamentos específicos extraídos das lacunas nas amostras. Seja específico. Se as amostras nunca usam a construção "não X, mas sim Y", liste-a. Se evitam um conjunto de vocabulário específico, nomeie as palavras]

Preencha cada seção a partir das amostras reais. Nenhum preenchimento genérico. Se um padrão não estiver presente, diga isso. Não duplique público ou pilares de tópico de about-me.md.

Separe proibições explícitas do usuário de padrões meramente ausentes nesta pequena amostra. Rotule estes últimos como provisórios, com contagens de amostras; a ausência por si só não estabelece uma proibição permanente. Amostras iniciais descrevem um estilo emprestado, nunca as experiências ou voz estabelecida do usuário.

Etapa 6. Confirmar e entregar

Diga ao usuário:

Seu perfil de voz está pronto. Dois arquivos estão agora no seu projeto: about-me.md e voice.md. Estas skills leem ambos os arquivos quando invocadas neste projeto; uma nova tarefa deve descobrir as skills e usar o mesmo contexto do projeto. Você pode abrir e editar qualquer arquivo a qualquer momento.

Você está pronto para começar. Aqui está o que pode fazer a seguir:

  • Diga "construir minha voz de newsletter" para criar instruções de escrita específicas para newsletter
  • Diga "escrever um post" para rascunhar um post do LinkedIn na sua voz
  • Diga "criar um gráfico" para criar um visual para um post
  • Diga "avaliar meu post" para obter feedback sobre um rascunho
  • Diga "otimizar meu perfil" para reconstruir seu perfil do LinkedIn

Cada uma dessas é uma skill separada. Escolha uma e vá.

O que esta skill produz

Dois arquivos na raiz do projeto:

  1. about-me.md: quem é o usuário, seu público, seus pilares de tópico, seu ponto de vista
  2. voice.md: o perfil de voz integrado, cobrindo sinais positivos (como a voz escreve) e sinais de ausência (o que a voz evita) em um documento

Regras

  • Quando esta skill for acionada, vá direto para a Etapa 1. Sem resumo, sem explicação, sem preâmbulo.
  • Sempre produza conteúdo de amostra dentro de um bloco de código para que o usuário possa copiar e colar a formatação exata sem perder quebras de linha ou espaços em branco. Use um bloco de código simples (três acentos graves sem tag de idioma).
  • Trabalhe a partir do que está nas amostras. Não invente padrões que não existem.
  • Mínimo de 3 amostras para detecção de padrões. Peça mais se houver menos de 3.
  • Se as amostras se contradizem, observe a contradição em voice.md em vez de suavizá-la.
  • Mantenha about-me.md abaixo de 300 palavras.
  • Mantenha voice.md abaixo de 500 palavras.
  • Use português brasileiro em todo o documento, a menos que as amostras estejam claramente em outra variante.
  • Nunca use travessões (—) em nenhum arquivo de saída ou em qualquer rascunho.
  • Não crie um perfil de ausência separado. Sinais de ausência residem dentro de voice.md.

Individual skills in this repo

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

Habilidades Relacionadas