🧩 O que é uma "skill" no Claude Code
Uma skill no Claude Code é um arquivo Markdown (.md) armazenado na pasta .claude/commands/ do seu projeto. Quando você digita /nome-skill, o Claude carrega esse arquivo inteiro como contexto de instrução e executa o comportamento descrito nele.
# Skill: YouTube Title Generator
Você é um especialista em YouTube.
Crie títulos virais para vídeos.
Use palavras de impacto.Este arquivo acima é o que a maioria das pessoas cria. Em 7 dias, param de usar. Vamos entender por quê — e o que fazer diferente.
Como uma Skill é Processada pelo Claude Code
O arquivo .md inteiro vira contexto de instrução. Quanto mais rico o arquivo, mais especializado o comportamento.
🏗️ Anatomia de uma Skill
Toda skill tem três componentes essenciais. A diferença entre uma skill fraca e uma poderosa está na profundidade de cada componente:
Define o contexto e o papel. Uma skill fraca coloca "você é um especialista". Uma skill poderosa define quem, para quem, com que conhecimento específico.
Especifica o que fazer, como fazer e o que evitar. Skills poderosas têm regras baseadas em aprendizados reais, não suposições genéricas.
Determina a estrutura e o estilo do resultado. Skills poderosas definem exatamente o que entregar, em que formato, com que critérios de qualidade.
💔 Por que a maioria das skills falha
A falha mais comum é tratar uma skill como um simples prompt salvo em arquivo. Esse equívoco fundamental produz resultados genéricos, inconsistentes e que rapidamente deixam de ser úteis na prática.
"Antes eu tinha uma skill chamada /youtube que só dizia 'você é um especialista em YouTube, crie títulos virais'. Depois de uma semana, parei de usar porque os resultados eram piores que digitar direto no ChatGPT. Eu precisava corrigir tudo manualmente, porque a skill não sabia nada sobre o meu canal, minha audiência, ou quais títulos historicamente performaram bem para mim."
# YouTube Titles Você é um especialista em YouTube. Crie títulos virais para vídeos. Use palavras de impacto como: "INCRÍVEL", "VOCÊ NÃO VAI ACREDITAR", "O SEGREDO QUE NINGUÉM TE CONTA"
# YouTube Title Generator — Canal Lucas ## Contexto do canal - 80k inscritos, nicho: produtividade+tech - Audiência: profissionais 28-42 anos - Tom: direto, sem hype, baseado em dados - CTR médio atual: 4.2% ## Títulos que mais performaram (CTR >7%) - "Como eu processo 200 emails em 20min" - "Notion vs Obsidian: testei os dois por 90 dias" - "3 ferramentas que substituíram meu time" ## Regras de título - Máximo 60 caracteres - Números específicos > números redondos - Evitar: "INCRÍVEL", "CHOCANTE", clickbait - Incluir: resultado concreto ou comparação ## Formato de saída Gere 5 opções variando: 1. Resultado numérico direto 2. Comparação/versus 3. Processo/como fazer 4. Tempo específico 5. Pergunta provocativa
🔍 Os 4 Pecados Capitais das Skills
Toda skill fracassada compartilha pelo menos um desses problemas estruturais:
Não sabe para quem trabalha, qual é o negócio, qual é o objetivo. Resultado: saída genérica que qualquer pessoa no mundo poderia obter.
Trabalha apenas com o conhecimento interno do modelo, que pode estar desatualizado em meses. Análises baseadas em suposições, não fatos.
Cada uso começa do zero, sem aprender com iterações anteriores. Você explica o mesmo contexto repetidamente.
Permanece idêntica ao primeiro dia, independente do feedback recebido ou dos resultados obtidos.
⚡ O potencial desperdiçado
O Claude Code foi projetado para agir como um agente especializado autônomo, capaz de usar ferramentas, acessar dados em tempo real, tomar decisões e executar tarefas complexas em sequência. Skills mal construídas transformam esse poder em um simples gerador de texto.
Skill como Gerador de Texto vs Skill como Agente Especializado
# YouTube Trend Analysis — Com Dados Reais
## Missão
Analisar tendências do momento e identificar
oportunidades de conteúdo baseadas em dados reais,
não suposições.
## Processo de execução (use as ferramentas)
### Passo 1 — Coletar dados atuais
Use WebSearch para buscar:
- "{tema} trends YouTube 2024 site:trends.google.com"
- "most viewed {nicho} youtube this week"
- "{tema} reddit discussion this week"
### Passo 2 — Verificar concorrentes
Use WebFetch em:
- socialblade.com/youtube/c/{canal-concorrente}
- Extrair: últimos 10 títulos, views por vídeo
### Passo 3 — Cruzar com histórico do canal
Compare os dados externos com a memória do canal
(arquivo: .claude/memory/channel-performance.md)
## Output esperado
- Top 3 oportunidades com dados de volume
- Ângulo único para o canal baseado no histórico
- Título sugerido com estimativa de CTR💡 Dica Prática
Antes de criar uma skill, escreva em uma frase o que ela fará que um humano competente faria. Se a resposta for "apenas escrever texto", você está construindo uma utility skill básica. Se envolver busca de dados, análise, decisão e execução sequencial, você está no território das super skills.
🎯 Skills sem contexto estratégico
Uma skill para criação de conteúdo que não conhece o canal, a audiência, o estilo e o histórico de performance produz conteúdo que qualquer pessoa com acesso ao Claude poderia gerar. O contexto estratégico é o que transforma uma ferramenta genérica em um ativo proprietário.
# YouTube Content Creator Você é um especialista em criação de conteúdo para YouTube. Quando eu pedir um título, crie títulos virais e chamativos. Quando pedir uma descrição, escreva descrições otimizadas para SEO. Sempre use emojis para engajamento.
"🔥 INCRÍVEL! Como a IA vai MUDAR sua vida em 2024 (Você não vai acreditar!) 🤯"
# YouTube — Canal Pedro Marques Tech ## Quem sou eu Pedro Marques, dev sênior 34 anos. Canal sobre ferramentas de dev e IA. 150k inscritos desde Mar/2023. ## Audiência - Devs pleno/sênior (25-40 anos) - Buscam: produtividade, ferramentas novas - Odeiam: hype sem substância - Engajam: benchmarks, comparações reais ## Tom de voz - Direto, técnico mas acessível - Zero sensacionalismo - Dados > opinião - Humor seco ocasional ## Histórico de performance Títulos com CTR > 8%: - "Testei o Cursor AI por 30 dias (dados reais)" - "Por que parei de usar VS Code" - "4 extensões que uso todo dia em 2024" ## Regras absolutas - NUNCA usar caps lock excessivo - NUNCA prometer "vida mudada" - SEMPRE incluir dado específico
"Testei 6 IAs de código por 2 semanas: qual ganhou (com benchmarks)"
🏢 Os 4 Eixos do Contexto Estratégico
Nicho, posicionamento, proposta de valor, diferenciais. Sem isso, a skill não sabe para onde está trabalhando.
Quem são, o que querem, o que os motiva, o que os trava. A audiência é o filtro de qualidade de todo output.
O que funcionou, o que não funcionou e por quê. Dados históricos reais valem mais do que qualquer teoria.
Metas de curto e longo prazo que a skill deve apoiar. O contexto muda com o momento estratégico.
🔄 Skills que esquecem tudo
Por padrão, cada uso de uma skill começa sem memória das interações anteriores. Isso significa que cada invocação reinventa a roda — você explica o contexto novamente, o Claude reprocessa decisões já tomadas e o aprendizado acumulado desaparece.
Memória Efêmera vs Memory OS — Diferença na Prática
"Na segunda-feira eu passei 10 minutos explicando para a skill que eu prefiro usar emojis com moderação, que minha audiência é profissional, que eu não gosto de 'CTAs agressivos' e que quero sempre 3 opções por entrega. Na quarta-feira, mesma skill, tive que explicar tudo de novo do zero. Na sexta, de novo. Calculei que isso me custa 50 minutos por semana só em recontextualização."
🧮 O Custo Real da Memória Zero
50 min/semana × 52 semanas = 43 horas por ano gastas explicando o que a skill deveria saber de memória. Isso é mais de uma semana de trabalho inteiro perdida por ano.
🔧 Skills que não usam ferramentas
Uma skill que trabalha apenas com o conhecimento interno do Claude está operando com uma fotografia do mundo tirada meses atrás. Sem acesso a dados em tempo real, APIs e ferramentas externas, ela produz análises baseadas em suposições, não em fatos verificáveis.
Pergunta: "Que tópicos de IA estão em alta para vídeos essa semana?"
"Conteúdo sobre IA costuma performar bem no YouTube atualmente. Alguns temas populares incluem:
• ChatGPT e seus usos práticos
• Automação com IA
• O futuro do trabalho com IA
• Ferramentas de IA para produtividade
Esses temas geralmente têm bom engajamento com audiências técnicas..."
Mesma pergunta. Mesma skill. Com ferramentas habilitadas.
"Analisando Google Trends e YouTube Search (dados de hoje):
📈 +340% essa semana:
• "Claude Projects" — lançamento ontem
• "Gemini 1.5 Pro context" — viral no X
📊 Alta consistente (>100k buscas/dia):
• Cursor AI vs GitHub Copilot
• n8n automation workflows
⚡ Oportunidade para seu canal:
Nenhum canal PT-BR cobriu Claude Projects ainda. Janela de 48-72h."
# Trend Check — Verificador de Tendências
## Missão
Verificar tendências reais ANTES de recomendar
qualquer tema de conteúdo.
## REGRA ABSOLUTA
Nunca recomendar temas baseado apenas no
conhecimento interno do modelo. Sempre buscar
dados externos antes de qualquer sugestão.
## Processo obrigatório
### 1. Google Trends (use WebFetch)
URL: https://trends.google.com/trends/explore?q={tema}&geo=BR
Extrair: interesse nos últimos 7 dias (0-100)
### 2. YouTube Search Volume (use WebSearch)
Query: "{tema} site:youtube.com/results"
Extrair: quantidade de vídeos nos últimos 30 dias
### 3. Reddit/Twitter pulse (use WebSearch)
Query: "{tema} site:reddit.com OR site:twitter.com after:2024-01-01"
Extrair: sentimento e volume de discussão
## Formato de saída
Para cada tema avaliado:
- Score de tendência (1-10)
- Dado específico que justifica o score
- Janela de oportunidade (horas/dias)
- Saturação de conteúdo PT-BR (baixa/média/alta)🛠️ Ferramentas que Transformam Skills
Busca informações atuais no Google. Tendências, notícias, volume de busca em tempo real.
Acessa URLs específicas. Google Trends, SocialBlade, analytics públicos.
Lê e salva arquivos. Base para o Memory OS — contexto persistente entre sessões.
Executa scripts. Processa CSVs de analytics, chama APIs externas, manipula dados.
✅ Resumo do Módulo 1.1
Próximo Módulo:
1.2 — A Base Karpathy: os 4 princípios que transformam o uso do Claude Code