MÓDULO 2.1

❌ Pilar 1 — Criando a Skill Corretamente

Por que não escrever skills manualmente, como usar o Skill Creator e como definir objetivo, formato de saída e contexto estratégico para uma skill eficaz.

6
Tópicos
35
Minutos
Intermediário
Nível
Prático
Tipo
1

❌ Por que não escrever skills manualmente

Escrever uma skill "na mão" em 5 minutos parece eficiente — mas produz uma skill que falha silenciosamente. A armadilha é que você sabe exatamente o que quer, então o rascunho parece ótimo para você. O problema é que o Claude não é você.

👤
Ana Carvalho
Analista de marketing em agência, cria skills de competidores

"Criei a skill de 'análise de concorrentes' em 5 minutos. Parecia completa. Na primeira vez que usei, recebi um relatório estruturado. Na segunda, veio em forma de perguntas. Na terceira, em bullet points genéricos sem nenhum dado. A mesma skill, três resultados completamente diferentes."

Problema raiz: Ana escreveu o objetivo mas esqueceu de especificar formato de saída, profundidade esperada e o que caracteriza uma "boa análise" para ela.

❌ Skill escrita em 5 minutos (manual)
# Análise de Concorrentes

Você é um analista de mercado.
Quando eu pedir, analise o
concorrente que eu mencionar.

Foque em pontos fortes e fracos.
Seja detalhado.
Problemas: sem formato de saída, sem critério de "detalhado", sem contexto do negócio, sem profundidade mínima
✅ Skill criada com Skill Creator (20 minutos)
# Análise de Concorrentes

## OBJETIVO
Analisar concorrentes diretos de uma
agência de marketing digital B2B,
produzindo relatório acionável para
decisões de posicionamento.

## OUTPUT FORMAT
Relatório em markdown com 5 seções:
1. Resumo Executivo (3 bullets)
2. Posicionamento e Proposta de Valor
3. Pontos Fortes (mín. 4 itens)
4. Vulnerabilidades Exploráveis (mín. 3)
5. Recomendações de Ação (mín. 3)

Extensão total: 400-600 palavras.
Tom: analítico, direto, executivo.

## CRITÉRIOS DE QUALIDADE
- Cada ponto forte cita evidência
  observável (site, preço, copy)
- Vulnerabilidades são oportunidades
  reais, não críticas genéricas
- Recomendações são específicas
  e implementáveis em 30 dias

🔍 O Que a Skill Manual Esqueceu

Formato de saída
Sem especificação, o Claude escolhe — e muda a cada sessão
Critérios de qualidade
"Detalhado" para você pode ser 100 ou 1.000 palavras
Contexto de uso
Para quem é o relatório? Qual a decisão que vai embasar?
2

🛠️ O Skill Creator do Claude

O Skill Creator é uma ferramenta nativa do Claude Code que age como um consultor: ele faz as perguntas certas antes de escrever a especificação. Em vez de você tentar lembrar de tudo, o Skill Creator extrai por perguntas o que você não saberia que precisava especificar.

Conversa real com o Skill Creator Simulação
SC
Pergunta 1/6 — Objetivo: O que esta skill deve fazer? Descreva em uma frase o que você quer que ela produza.
Quero uma skill que crie roteiros para vídeos do YouTube sobre IA e produtividade.
👤
SC
Pergunta 2/6 — Resultado esperado: Como é o output ideal? Qual o formato, extensão e estrutura do roteiro perfeito para você?
Roteiro com hook nos primeiros 30 segundos, desenvolvimento em tópicos, call-to-action no final. Uns 800 a 1.200 palavras.
👤
SC
Pergunta 3/6 — Audiência: Para quem é o conteúdo? Qual o perfil de quem assiste seus vídeos?
Profissionais de 25-40 anos que querem usar IA no trabalho mas não são técnicos. Sem jargão, exemplos práticos.
👤
SC
Pergunta 4/6 — Critérios de qualidade: Como você sabe se um roteiro ficou bom? O que distingue excelente de medíocre?
Hook que gera curiosidade real, não clickbait. Cada tópico com exemplo concreto. Final com ação específica que a pessoa pode fazer hoje.
👤
SC
Pergunta 5/6 — Restrições: O que esta skill NUNCA deve fazer? Comportamentos a evitar, temas proibidos, tons inadequados?
Nunca prometer que IA vai substituir empregos. Não usar termos como "revolucionar" ou "game-changer". Não fazer listas com mais de 5 itens.
👤
SC
Pergunta 6/6 — Contexto de negócio: Qual o nome do canal, posicionamento, e algum detalhe que diferencia seu conteúdo dos concorrentes?
youtube-roteiro.md Skill File gerado
# YouTube Roteiro — Canal IA na Prática

## IDENTIDADE DO CANAL
Canal "IA na Prática" — 47k inscritos, foco em profissionais
não-técnicos que querem usar IA no trabalho diário.
Diferencial: exemplos reais, sem hype, sem jargão.

## OBJETIVO
Criar roteiro completo para vídeo de 8-12 minutos sobre
um tema de IA/produtividade, otimizado para retenção
e conversão de inscrição.

## PERFIL DA AUDIÊNCIA
- Profissionais 25-40 anos, cargos: gerente, analista, consultor
- Usam ferramentas básicas (Office, Notion) mas não codificam
- Motivação: economizar tempo, parecer atualizado para gestores
- Medo: ficar obsoleto, não saber por onde começar

## OUTPUT FORMAT
### Estrutura obrigatória:
1. HOOK (0-30 segundos): pergunta ou afirmação que gera tensão
2. PROMESSA (30-60 segundos): o que a pessoa vai aprender/ganhar
3. DESENVOLVIMENTO: 3-4 tópicos, cada um com exemplo concreto
4. VIRADA: insight inesperado que eleva o conteúdo
5. CTA: ação específica que a pessoa pode fazer hoje

### Especificações técnicas:
- Extensão: 800-1.200 palavras
- Tom: direto e prático, como um colega experiente explicando
- Sem bullet lists com mais de 5 itens
- Cada tópico do desenvolvimento: 150-200 palavras

## CRITÉRIOS DE QUALIDADE
- Hook gera curiosidade genuína, não clickbait
- Pelo menos 2 exemplos com números ou situações reais
- CTA é ação de 5 minutos ou menos (não "comece a usar IA")
- Nenhuma lista no desenvolvimento (apenas prosa fluida)

## PROIBIÇÕES ABSOLUTAS
- Nunca mencionar "substituição de empregos"
- Palavras banidas: revolucionar, game-changer, disruptivo, incrível
- Não fazer previsões sobre o futuro da IA
- Não citar ferramentas pagas sem mencionar alternativa gratuita
3

🎯 Definindo objetivo e resultado esperado

A clareza do objetivo é o fator mais preditivo da qualidade do output. Skills com objetivos vagos produzem resultados vagos não porque o Claude é incapaz, mas porque ambiguidade instrucional é resolvida com interpretação — que raramente coincide com sua expectativa.

briefing-skill-template.md Template
## BRIEFING DE SKILL

**Nome da skill:** [nome-descritivo-sem-espacos]
**Data de criação:** [data]
**Versão:** 1.0

### 1. OBJETIVO PRINCIPAL
[Verbo de ação] + [o quê] + [para quem] + [para que finalidade]
Exemplo: "Criar roteiro de 800-1200 palavras para profissional
não-técnico que quer postar vídeo sobre IA no YouTube semanal."

### 2. RESULTADO ESPERADO
- Formato físico: [markdown / texto / JSON / HTML]
- Estrutura: [seções obrigatórias com ordem]
- Extensão: [mínimo e máximo em palavras]
- Tom: [adjetivos que descrevem a voz]
- Exemplo do output ideal: [descrever ou colar exemplo]

### 3. CONTEXTO DE USO
- Quem usa esta skill: [nome/papel]
- Quando usa: [frequência, ocasião]
- O que faz com o output: [próximo passo após usar]

### 4. CRITÉRIO DE DONE
Um output está concluído quando: [descrever condição]
Um output está ruim quando: [descrever condição de falha]

### 5. RESTRIÇÕES
- Nunca fazer: [lista de comportamentos proibidos]
- Tom proibido: [descrição de voz inadequada]
- Temas a evitar: [assuntos fora do escopo]
❌ Objetivo vago
## OBJETIVO
Você é um assistente de marketing.
Ajude a criar conteúdo para redes
sociais quando eu pedir.
✗ "Conteúdo" — qual tipo? Post? Thread? Carrossel?
✗ "Redes sociais" — qual plataforma?
✗ "Quando eu pedir" — sem contexto de uso
✅ Objetivo preciso
## OBJETIVO
Criar thread de 8-10 posts para LinkedIn
de um fundador de startup SaaS B2B que
quer compartilhar aprendizados de growth.
Audiência: outros fundadores e C-levels.
Frequência: 2x por semana.
Métrica: taxa de engajamento > 3%.
✓ Formato específico (thread 8-10 posts)
✓ Plataforma definida (LinkedIn)
✓ Audiência clara (fundadores/C-levels)
4

📋 Formato de saída e critérios de qualidade

O formato de saída é o contrato da skill. Sem especificação explícita, o Claude escolhe o formato que parece mais razoável — e "razoável" é subjetivo. Com especificação precisa, o output é consistente independente da sessão ou da pessoa que usa.

analise-mercado.md — seção OUTPUT FORMAT Skill File
## OUTPUT FORMAT

### Estrutura obrigatória (nesta ordem):
```
# [TÍTULO DA ANÁLISE] — [Data]

## Resumo Executivo
[3 bullets com os insights mais críticos]

## Tamanho e Crescimento do Mercado
[1 parágrafo, 80-120 palavras, com números]

## Tendências Dominantes (3-5)
[Cada tendência: nome em negrito + 2-3 frases de explicação]

## Oportunidades para [Nome da Empresa]
[3 oportunidades específicas com raciocínio]

## Riscos e Ameaças
[2-3 riscos com probabilidade: Alta/Média/Baixa]

## Recomendação de Ação (próximos 90 dias)
[1 ação principal com justificativa de 50 palavras]
```

### Especificações de formato:
- Total: 500-700 palavras
- Todos os números com fonte entre parênteses
- Tom: executivo, objetivo, sem jargão técnico
- Usar markdown: H2 para seções, negrito para termos-chave
- Proibido: bullet com mais de 8 itens, parágrafos com + de 5 linhas

### Critérios de qualidade:
- APROVADO: cada tendência cita dado observável do mercado
- APROVADO: oportunidades são específicas para este negócio
- REPROVADO: análise poderia ser de qualquer empresa do setor
- REPROVADO: recomendação final é genérica ("investir em IA")

O que acontece sem vs com critérios de qualidade:

Run #1 — sem critérios

O mercado de IA está em crescimento acelerado. As principais tendências incluem automação, LLMs e agentes. Há oportunidades para empresas que investirem nessas tecnologias. Recomendo estudar o mercado e definir uma estratégia.

Run #2 — sem critérios (mesmo input)

**Análise do Mercado de IA**. Tendências: 1) Adoção corporativa crescendo 45% ao ano 2) Modelos multimodais 3) IA embarcada em produtos. Oportunidades identificadas no setor B2B SaaS. Riscos: regulação, custo de implementação.

Run #1 — com critérios definidos

# Análise de Mercado — IA Produtividade B2B — Abril 2026

## Resumo Executivo
• Mercado de ferramentas de IA B2B atingiu $47B em 2025, crescimento de 62% YoY (Gartner)
• 73% das empresas Fortune 500 já têm projeto de IA em produção (McKinsey Q1/2026)
• Janela de vantagem competitiva para early adopters: estimada em 18-24 meses

5

🏢 Contexto estratégico — O ingrediente secreto

O contexto estratégico transforma uma skill de ferramenta genérica em ativo proprietário do negócio. É o conjunto de informações que fariam um funcionário recém-contratado trabalhar com a mesma qualidade de alguém que está na empresa há 3 anos.

❌ Versão genérica (5 linhas)
# YouTube Script Writer

Você é um redator de YouTube.
Escreva roteiros sobre tecnologia.
Seja informativo e engajante.
Use linguagem clara.
Inclua call-to-action no final.
Poderia ser usado por qualquer criador de conteúdo do planeta. Zero diferencial.
✅ Com contexto estratégico (40+ linhas)
# YouTube Roteiro — Canal Marcos Cunha

## CONTEXTO DO CANAL
Canal: "Marcos Cunha — IA no Trabalho"
Inscritos: 89k | Crescimento: +2.3k/mês
Monetização: curso + consultoria B2B
Meta 2026: 150k inscritos, 3x receita

## POSICIONAMENTO
"O canal para profissionais sérios que
querem resultado, não hype."
Diferencial vs concorrentes: não ensino
ferramentas, ensino sistemas completos.

## AUDIÊNCIA DOCUMENTADA
Persona primária — "O Gerente Ansioso":
- Cargo: gerente/coordenador 30-42 anos
- Dor: equipe cobrando sobre IA, chefe
  perguntando o que está fazendo
- Objetivo: implementar IA sem virar
  técnico ou depender de TI
- Redes: LinkedIn (diário), YouTube
  (busca solução para problema específico)
...
youtube-roteiro-contexto-completo.md Skill File Completo
# YouTube Roteiro — Canal Marcos Cunha

## [CONTEXTO: NEGÓCIO] ← Camada 1
Canal: "Marcos Cunha — IA no Trabalho" | 89k inscritos
Modelo: YouTube → audiência gratuita → curso R$997 → consultoria B2B
Receita atual: R$28k/mês | Meta: R$85k/mês até Dez/2026
CTR médio dos últimos 30 vídeos: 4.2% | Retenção média: 52%

## [CONTEXTO: AUDIÊNCIA] ← Camada 2
Persona: "O Gerente Ansioso"
- Gerente/coordenador, 30-42 anos, empresas 50-500 funcionários
- Usa: Office, Teams, Notion; não usa: Python, APIs, código
- Medo primário: ficar obsoleto enquanto a equipe avança
- Gatilho de compra: quando sente que está atrasado em relação a pares
- Objeção principal: "muito complexo para minha realidade"

## [CONTEXTO: HISTÓRICO] ← Camada 3
Vídeos com melhor performance (últimos 6 meses):
- "Como organizo meu trabalho com 3 ferramentas de IA" → 187k views
- "Testei 10 prompts de produtividade: só 3 funcionam" → 143k views
- "IA para reuniões: o que realmente economiza tempo" → 98k views
Padrão dos top performers: título com número + promessa específica + desmistificação

Vídeos que não funcionaram:
- Tutoriais técnicos passo-a-passo → audiência não é técnica
- Análises de notícias de IA → audiência quer aplicação, não notícia

## [CONTEXTO: RESTRIÇÕES] ← Camada 4
NUNCA mencionar:
- Substituição de empregos por IA
- Ferramentas que custam +R$200/mês sem alternativa gratuita
- Comparações com concorrentes específicos por nome
- Previsões sobre futuro da IA além de 12 meses

TOM PROIBIDO: hype, jargão técnico, academicismo, superlativos

## OBJETIVO
Criar roteiro de 800-1.200 palavras para vídeo de 8-12 minutos que:
1. Resolve uma dor específica do Gerente Ansioso
2. Demonstra aplicação prática (não teoria)
3. Tem hook que funciona no YouTube (curiosidade + tensão)

## OUTPUT FORMAT
### Estrutura:
TÍTULO SUGERIDO: [3 opções A/B/C para teste]
THUMBNAIL CONCEPT: [descrição de visual para designer]
---
[HOOK — 0:00-0:45]
[PROMESSA — 0:45-1:30]
[TÓPICO 1 — 1:30-4:00]
[TÓPICO 2 — 4:00-7:00]
[TÓPICO 3 — 7:00-10:00]
[VIRADA — 10:00-11:00]
[CTA — 11:00-12:00]

### Notas no roteiro:
[Indicar B-roll sugerido entre colchetes]
[Indicar pausa para respirar com (pausa)]
Camada 1 — Negócio
Métricas reais, modelo de receita, metas quantificadas
Camada 2 — Audiência
Persona nomeada com medos, objetivos e objeções reais
Camada 3 — Histórico
O que funcionou, o que falhou, com dados de performance
Camada 4 — Restrições
Proibições explícitas de conteúdo, tom e comportamento
6

✅ Validando sua skill antes de usar

Uma skill não testada é uma hipótese em produção. Validação sistemática antes do uso real transforma a skill de uma aposta em uma ferramenta confiável. O custo de um teste de 30 minutos é infinitamente menor que o custo de um erro em um momento crítico.

Checklist de Validação — execute antes do uso real

Teste de caso normal: input padrão → output atende o formato especificado?
Teste de edge case #1: input fora do padrão (muito curto, ambíguo, outro idioma)
Teste de consistência: 3 runs com o mesmo input → outputs têm a mesma estrutura?
Verificação de contexto: o output usa informações específicas do contexto ou é genérico?
Verificação de restrições: o output viola alguma das proibições definidas?
Teste de carga: funciona bem com input 3x mais longo que o normal?
youtube-roteiro-tests.md Test Suite
# Test Suite — YouTube Roteiro Skill
Data de criação: 2026-04-01 | Versão da skill: 1.0

## TESTE 1 — Caso Normal
Input: "Como usar o Claude Code para automatizar tarefas repetitivas"
Output esperado:
  - 3 opções de título com número
  - Estrutura com 7 seções marcadas (HOOK, PROMESSA, etc.)
  - Extensão 800-1.200 palavras
  - Mínimo 1 exemplo com situação concreta
  - CTA para ação de 5 minutos ou menos
Status: [ ] PASSOU  [ ] FALHOU
Notas: ___________________

## TESTE 2 — Edge Case: Input muito vago
Input: "IA"
Output esperado:
  - Skill deve pedir clarificação OU
  - Escolher subtema específico e avisar escolha
  - NÃO deve gerar roteiro genérico sobre "tudo de IA"
Status: [ ] PASSOU  [ ] FALHOU
Notas: ___________________

## TESTE 3 — Verificação de restrições
Input: "Como a IA vai substituir empregos nos próximos 5 anos"
Output esperado:
  - Skill deve redirecionar para ângulo de oportunidade
  - NÃO deve criar roteiro sobre substituição de empregos
  - NÃO deve usar palavras como "revolucionar"
Status: [ ] PASSOU  [ ] FALHOU
Notas: ___________________

## RESULTADO FINAL
Testes aprovados: ___ / 3
Aprovado para uso em produção: [ ] SIM  [ ] NÃO
Data de próximo review: ___________

Resumo do Módulo 2.1

Não escrever manualmente — a skill de 5 minutos da Ana produzia 3 outputs completamente diferentes para o mesmo input
Skill Creator — 6 perguntas estruturadas que extraem o que você não saberia que precisava especificar
Briefing de skill com objetivo, resultado esperado, contexto, critério de done e restrições
OUTPUT FORMAT preciso — estrutura obrigatória, extensão, tom, e critérios de APROVADO/REPROVADO
Contexto em 4 camadas: negócio (métricas reais), audiência (persona com medos), histórico (o que funcionou) e restrições
Test suite — 3 testes mínimos antes de ir para produção: caso normal, edge case, verificação de restrições

Próximo Módulo:

2.2 — Ferramentas e Dados: conectando skills a fontes externas em tempo real