"Analyze an author's writing style from docx/markdown samples and generate a structured voice profile. Use when the user has 3-5 writing samples and wants a perfil-de-voz.md (voice profile) capturing tone, structure, vocabulary, analogies and pedagogical patterns — útil para clonar a voz de um autor."
Install
npx skillscat add sallzzbr/hefesto-publico/analisar-voz Install via the SkillsCat registry.
Analisar Voz
Read the provided documents and extract a structured voice profile for the author.
Input
The user will specify 3-5 documents (docx, markdown, txt) to analyze. Read each one using the Read tool. Para arquivos .docx, a skill oficial docx da Anthropic precisa estar instalada no ambiente.
Analysis dimensions
For each document, identify patterns in:
- Tom e registro — formal/informal, nivel de formalidade, uso de "voce" vs "senhor"
- Abertura de secoes — como o autor comeca capitulos, topicos, paragrafos
- Estrutura de frase — comprimento medio, uso de perguntas retoricas, listas
- Fechamento de secoes — como encerra (motivacional, reflexivo, resumo)
- Analogias e metaforas — exemplos recorrentes, fontes de analogia (cotidiano, profissional)
- Vocabulario caracteristico — palavras e expressoes frequentes, bordoes
- Relacao com o leitor — como se posiciona (professor, mentor, colega), como trata duvidas
- Citacoes e referencias — como integra fontes academicas no texto
- Elementos pedagogicos — caixas (Saiba Mais, Na Pratica, Reflita), check-ins, exercicios
- Marcadores de personalidade — humor, empatia, assertividade, humildade
Output format
Resolver o destino nesta ordem: (1) local_voz na seção ## Paths do workspace doCLAUDE.md; (2) local_voz nos defaults do usuário (~/.claude/bragir/defaults.md); (3)
convenção descoberta no cwd — perfil existente em ./voz/perfil-de-voz.md ou legado./voice-profile.md; (4) default documentado ./perfil-de-voz.md. Exatamente um candidato
existente é usado; mais de um candidato concorrente exige perguntar; nenhum candidato cai no
default documentado. Os paths literais são ilustrativos do default, não hardcode.
Cada projeto que consome a voz tem o seu próprio perfil — assim dá pra tunar tom e exemplos por
contexto sem mexer no default global. Um arquivo só de scaffold (placeholders <!-- -->) conta
como existente para ESCRITA: é exatamente ele que você vai preencher. Se resolver o nome legado,
ofereça renomear para perfil-de-voz.md em vez de criar um segundo arquivo.
Override (só quando o usuário pedir explicitamente, ex.: "atualiza meu perfil de voz padrão" ou "atualiza o perfil de voz do bragir"): escrever em ${CLAUDE_PLUGIN_ROOT}/perfil-de-voz.md. Esse é o fallback usado por escrever-como-antonio quando o projeto não tem ./perfil-de-voz.md próprio.
Após gerar o perfil resolvido, sugira ao usuário commitar o arquivo no repo do projeto.
Use esta estrutura:
# Perfil de Voz — [Nome do Autor]
## Resumo (2-3 frases)
## Tom e registro
## Como abre secoes
## Como fecha secoes
## Analogias recorrentes
## Vocabulario caracteristico
## Estrutura de frase
## Relacao com o leitor
## Uso de citacoes
## Elementos pedagogicos
## Exemplos reais (trechos representativos)Include 2-3 trechos reais (curtos, <30 palavras) dos documentos analisados como exemplos concretos do estilo.
Important
- Extract patterns, not individual instances. The profile should generalize.
- Note contradictions or register shifts between documents (e.g., more formal in e-book vs. informal in video script).
- The profile will be used as input for content generation — be specific enough that another AI could replicate the voice.