a2ngerer/claude_onboarding_agent

Configuração de Voz da Marca

Este skill configura o Claude para escrever no tom de voz da sua marca nas plataformas selecionadas. Ele gera um pequeno ponteiro no CLAUDE.md e um arquivo .claude/rules/content-voice-<plataforma>.md para cada plataforma escolhida. Não configura ferramentas de publicação, análise, pipelines de mídia ou agendamento – isso está fora do escopo e é intencional.

Contexto de handoff: Leia skills/_shared/consume-handoff.md e execute-o com o bloco de handoff (se houver). O helper garante as seguintes variáveis locais: detected_language, existing_claude_md, inferred_use_case, repo_signals, graphify_candidate. Use detected_language para toda a prosa voltada ao usuário; o conteúdo gerado nos arquivos permanece em inglês.

CLAUDE.md existente: Se existing_claude_md: true, NÃO o sobrescreva. Adicione uma nova seção delimitada ao final do arquivo:

<!-- onboarding-agent:start setup=content-voice skill=content-voice-setup section=claude-md -->
## Claude Onboarding Agent — Configuração de Voz da Marca
...conteúdo gerado...
<!-- onboarding-agent:end -->

Se o bloco delimitado já existir de uma execução anterior, substitua apenas o conteúdo entre os marcadores; deixe o restante intacto. Envolva as entradas geradas do .gitignore em marcadores # onboarding-agent: content-voice — start / — end para que o /upgrade-setup possa atualizá-las de forma não destrutiva.

Arquivos de Suporte

Leia-os sob demanda na etapa que os invoca. Não leia antecipadamente.

• skills/_shared/consume-handoff.md — parse do handoff do orquestrador + fallback inline (preâmbulo, antes do Passo 1)
• skills/_shared/offer-superpowers.md — adesão canônica ao Superpowers (Passo 1)

Passo 1: Instalar Dependências

Leia skills/_shared/offer-superpowers.md e execute-o com skill_slug: content-voice-setup, mandatory: false, capability_line: "Uma biblioteca de skills para Claude Code muito usada e gratuita. O skill de brainstorming é útil para explorar ângulos antes de definir uma voz para uma peça específica." O helper pergunta ao usuário, delega para skills/_shared/installation-protocol.md em caso de sim, e define superpowers_installed, superpowers_scope, superpowers_method.

Passo 2: Perguntas de Contexto

Pergunte uma de cada vez:

1. "Para quais plataformas você cria conteúdo com voz? (multisseleção — letras separadas por vírgula, pelo menos uma) A) YouTube (vídeo longo / roteiros) B) Vídeo curto (Instagram Reels / TikTok / Shorts) C) Newsletter / blog (texto longo) D) Podcast (áudio conversacional)"

   Converta a resposta em uma lista de letras. Exija pelo menos uma seleção — pergunte novamente uma vez se a entrada estiver vazia. Armazene como selected_platforms. Mapeie para slugs:

   • A → youtube
   • B → shortform
   • C → newsletter
   • D → podcast

2. "Como você descreveria a voz da sua marca? Seja o mais específico possível — quanto mais detalhe, melhor o Claude combinará com seu estilo. Exemplos: 'educacional mas casual, como explicar coisas para um amigo inteligente', 'líder de pensamento profissional em fintech', 'comentário tecnológico engraçado e irreverente', 'conteúdo de bem-estar caloroso e pessoal'"

   Armazene a resposta exata como brand_voice. Os arquivos de regra por plataforma a injetarão no cabeçalho.

3. "Quem é seu público-alvo? (ex.: 'desenvolvedores de 25 a 40 anos interessados em ferramentas de IA', 'pequenos empresários sem conhecimento técnico', 'entusiastas de fitness em busca de treinos rápidos')"

   Armazene como target_audience.

Passo 3: Emitir Regras de Voz por Plataforma

Para cada slug em selected_platforms, escreva um arquivo de regra em .claude/rules/content-voice-<slug>.md. Se o arquivo já existir, pule a escrita e registre Pulado .claude/rules/content-voice-<slug>.md (já existe) — NÃO sobrescreva edições do usuário.

Cada arquivo de regra é autocontido (≤ 40 linhas) e substitui brand_voice e target_audience no cabeçalho. Use os modelos abaixo, substituindo [brand_voice] e [target_audience] pelas respostas capturadas.

content-voice-youtube.md

# Voz da Marca — YouTube (vídeo longo)

Perfil de voz: [brand_voice]
Público-alvo: [target_audience]

## Regras de formato
- Todo roteiro começa com um gancho nos primeiros 30 segundos: prometa um benefício concreto que o espectador obterá até o final.
- Estrutura: gancho → contextualização (qual problema / pergunta) → desfecho (a resposta, história ou demonstração) → CTA.
- O CTA nomeia uma única ação. Não encadeie listas como "curta, inscreva-se, comente, junte-se".
- Mantenha frases legíveis em voz alta — prefira ≤ 20 palavras por linha falada.

## Regras de tom
- Siga o perfil de voz acima em cada rascunho. Se um rascunho soar como comentário genérico de IA, reescreva a linha de abertura até que pareça [brand_voice].
- Dirija-se diretamente ao público-alvo. Considere o conhecimento básico deles; não explique o que já sabem.

## Não fazer
- Não escreva um título-isca que a introdução não cumpra — o gancho deve ser uma preparação verdadeira para o desfecho.

content-voice-shortform.md

# Voz da Marca — Vídeo curto (Reels / TikTok / Shorts)

Perfil de voz: [brand_voice]
Público-alvo: [target_audience]

## Regras de formato
- A linha 1 É o gancho. A parada da rolagem acontece nos primeiros dois segundos.
- Uma única ideia por postagem. Se uma segunda ideia for importante, é uma postagem separada.
- Termine com uma pergunta, um CTA ou uma conclusão concreta — nunca deixe no ar.
- Mantenha a contagem total de palavras enxuta (≈ 30–60 palavras faladas para um corte de 30 segundos).

## Regras de tom
- O perfil de voz corresponde exatamente a [brand_voice] — o formato curto amplifica a voz, então tom genérico é o modo de falha padrão.
- Mire em [target_audience]; não suavize para um público mais amplo.

## Não fazer
- Não enterre o gancho após a linha 1. Não comece com uma enrolação como "Então, hoje quero falar sobre…".

content-voice-newsletter.md

# Voz da Marca — Newsletter / blog (texto longo)

Perfil de voz: [brand_voice]
Público-alvo: [target_audience]

## Regras de formato
- A linha de assunto é específica, não engenhosa — nomeie o benefício ou a pergunta que o leitor terá respondida.
- A abertura é pessoal ou baseada em história (1–3 frases); depois uma ideia central; depois uma conclusão clara; depois um CTA simples.
- Quebras de seção são permitidas, mas não obrigatórias — prefira um argumento coeso a um listicle.
- Termine com uma frase que o leitor possa encaminhar a um colega.

## Regras de tom
- O perfil de voz corresponde a [brand_voice] em todo o texto — nenhuma seção deve soar como se um autor diferente a tivesse escrito.
- Dirija-se a [target_audience] pela situação real deles, não por rótulos de cargo.

## Não fazer
- Não envie uma edição sem um benefício específico que o leitor possa aplicar ou lembrar.

content-voice-podcast.md

# Voz da Marca — Podcast (áudio conversacional)

Perfil de voz: [brand_voice]
Público-alvo: [target_audience]

## Regras de formato
- Abra a frio com um gancho — uma cena, uma pergunta ou um momento concreto do episódio. A música de abertura vem depois.
- As transições são faladas, não cortadas abruptamente: nomeie a mudança ("Vamos voltar a isso daqui a pouco — primeiro, …").
- Prepare perguntas com antecedência, mas deixe espaço para acompanhamento; um roteiro pré-escrito soa como roteiro pré-escrito.
- Termine com o CTA do convidado (se houver), depois um único CTA do anfitrião.

## Regras de tom
- O perfil de voz [brand_voice] se aplica às falas do anfitrião; combine com a energia dos convidados em vez de forçá-los a se adequar.
- Mantenha o jargão no nível de [target_audience]; traduza no primeiro uso.

## Não fazer
- Não dê uma palestra — mantenha o tom conversacional. Se um segmento parecer um monólogo, corte-o ou reformule-o como uma pergunta.

Colete a lista de arquivos efetivamente escritos (menos os pulados por já existirem) como emitted_voice_files para o resumo de conclusão.

Passo 4: Gerar Artefatos

CLAUDE.md

# Instruções do Claude — Voz da Marca

## Marca
Plataformas: [lista separada por vírgulas de selected_platforms]
Voz da marca: [brand_voice]
Público-alvo: [target_audience]

## Escopo
Esta configuração cobre apenas voz — não publicação, análise ou pipelines de mídia. Para fluxos de trabalho de conteúdo mais longos, adicione outros skills ou ferramentas por cima.

## Regras de voz (por plataforma)
[Para cada slug em selected_platforms, emita um bullet apontando para o arquivo de regra:]
- YouTube: `.claude/rules/content-voice-youtube.md`
- Vídeo curto: `.claude/rules/content-voice-shortform.md`
- Newsletter / blog: `.claude/rules/content-voice-newsletter.md`
- Podcast: `.claude/rules/content-voice-podcast.md`

## Diretrizes
- Sempre escreva na voz da marca definida acima — nunca soe genérico ou como uma IA típica.
- Antes de redigir, consulte o arquivo `.claude/rules/content-voice-<plataforma>.md` relevante para a plataforma alvo.
- Quando perguntado sobre adaptações entre plataformas, aplique o arquivo de regras de cada plataforma individualmente — não copie e cole entre formatos.

[Incluir APENAS se superpowers_installed for true]
## Superpowers
Superpowers está instalado. Para sessões de ideação e planejamento de séries de conteúdo, use `superpowers:brainstorming` para explorar ângulos antes de definir uma direção.

.gitignore

# Arquivos de mídia grandes
*.mp4
*.mov
*.avi
*.psd
*.ai
*.sketch
*.fig

# SO
.DS_Store
Thumbs.db

# Configurações locais do Claude
.claude/settings.local.json

Passo 5: Escrever Metadados de Upgrade

Defina setup_slug: content-voice, skill_slug: content-voice-setup. Resolva plugin_version a partir do próprio plugin.json do plugin. Em seguida, siga skills/_shared/write-meta.md para criar ou mesclar ./.claude/onboarding-meta.json.

Passo 6: Renderizar Seções Âncora

Leia skills/_shared/anchor-mapping.md. Localize a linha para setup_type: content-voice. Para cada slug de âncora nessa linha:

1. Chame skills/_shared/render-anchor-section.md com:
   • setup_type: content-voice
   • skill_slug: content-voice-setup
   • anchor_slug: <slug>
   • target_file: ./CLAUDE.md
   • fallback_content: <fallback incorporado de skills/anchors/SKILL.md para aquele slug>
2. Se um arquivo ./AGENTS.md foi gerado anteriormente neste skill, repita a chamada com target_file: ./AGENTS.md.

Não falhe se qualquer chamada individual de render-anchor-section.md retornar placeholder. Colete slugs renderizados / placeholder para o resumo de conclusão.

Para cada chamada, também capture render_freshness. Quando for algo diferente de network ou cache (ou seja, fallback ou embedded), registre o par (anchor_slug, render_freshness) em anchor_freshness_notes. A linha "Freshness das âncoras" no resumo de conclusão consome esta lista.

Passo 7: Resumo de Conclusão

✓ Configuração de voz da marca concluída!

Escopo: voz da marca + regras de tom por plataforma. Publicação, análise e
pipelines de mídia NÃO são cobertos — este skill é intencionalmente restrito.

Arquivos criados:
  CLAUDE.md                                    — marca, escopo, ponteiros para regras de voz
  .claude/rules/content-voice-<slug>.md        — um arquivo por plataforma selecionada [listar emitted_voice_files; notar os pulados como "(já existia — deixado intacto)"]
  .gitignore                                   — regras para arquivos de mídia grandes
  .claude/onboarding-meta.json                 — marcador de configuração para /upgrade-setup

Skills externos:
  [✓ Superpowers instalado via superpowers_method (superpowers_scope)]
  [pulado — instale depois com: /plugin install superpowers@claude-plugins-official]
  [⚠ Falha na instalação do Superpowers — instale manualmente: https://github.com/obra/superpowers]

Freshness das âncoras:
  [omitir todo o bloco se anchor_freshness_notes estiver vazio; caso contrário, uma linha por entrada:
   Âncora <anchor_slug> servida de <render_freshness> — considere executar /anchors para atualizar.]

Próximos passos:
  Inicie uma nova sessão do Claude e diga: "Esboce um [roteiro para YouTube | gancho para vídeo curto | edição de newsletter | abertura para podcast] sobre [tópico] na minha voz da marca"
  Ou: "Adapte este post de blog para Instagram Reels, seguindo minhas regras de voz curta"
  - Execute `/anchors` a qualquer momento para atualizar as seções derivadas de âncoras. Se alguma seção foi renderizada como placeholder devido ao modo off-line, execute `/anchors` novamente quando estiver on-line.