❌ 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ê.
"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.
# 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.
# 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
🛠️ 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.
# 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
🎯 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 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 Você é um assistente de marketing. Ajude a criar conteúdo para redes sociais quando eu pedir.
## 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 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.
## 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:
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.
**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.
# 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
🏢 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.
# 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.
# 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 — 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)]
✅ 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
# 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
Próximo Módulo:
2.2 — Ferramentas e Dados: conectando skills a fontes externas em tempo real