📚 Fundamentos

Uma skill é um arquivo Markdown salvo em .claude/skills/nome-skill.md que instrui o Claude Code como executar uma tarefa específica. Você a invoca digitando /nome-skill no chat.

Sem entender o que é uma skill no nível técnico, você vai criar arquivos que parecem skills mas são apenas prompts — e vai se perguntar por que os resultados variam tanto a cada uso.

.claude/skills/, disparo via /nome-skill, contexto de projeto, arquivo claude.md.

Skills comuns são apenas prompts salvos em arquivo. Exemplo típico: Você é um especialista em conteúdo. Escreva sobre $TEMA. — sem canal, sem audiência, sem histórico, sem voz.

Estudos de uso mostram que criadores perdem em média 43 horas por ano reescrevendo e corrigindo outputs de skills genéricas. Identificar as falhas é o primeiro passo para eliminá-las.

falta de contexto estratégico, ausência de dados reais, sem ciclo de melhoria, prompts genéricos, signal-dashboard.md.

O Claude Code pode ler arquivos, buscar na web, executar código e encadear decisões. Uma skill fraca ignora tudo isso e o reduz a autocomplete com mais tokens.

Cada skill sem ferramentas é um funcionário digital sem acesso ao computador — presente na sala, mas inútil para o trabalho real. O custo de oportunidade é enorme.

agente vs. autocomplete, ferramentas nativas do Claude Code, custo de oportunidade, WebFetch, Read/Write.

Uma skill para YouTube sem saber o canal, audiência, estilo e histórico é idêntica ao que qualquer pessoa digitaria no ChatGPT. O arquivo context/canal.md com dados do negócio é o que gera personalização real.

O contexto estratégico é o que diferencia uma super skill de uma ferramenta de commodity — e é impossível de copiar por concorrentes, porque contém o DNA do seu negócio.

context/canal.md, perfil da audiência, objetivos estratégicos, histórico de feedback, claude.md.

Cada invocação de uma skill comum começa do zero. Você aprovou um formato de post na semana passada? A skill não sabe. Sem um arquivo memory-os.md, cada sessão reinventa a roda.

Skills sem memória forçam você a reexplicar o contexto toda vez — o equivalente a demitir e contratar um novo funcionário a cada reunião. O Memory OS resolve isso com zero esforço extra por uso.

memória efêmera, ausência de aprendizado, memory-os.md, contexto perdido, aprendizado acumulado.

Skills que dependem só do conhecimento interno do modelo são cegas para o mundo real. Uma skill de análise de tendências que não usa WebFetch ou um arquivo signals/trends.json está operando com dados de corte de treino, não de hoje.

Conectar skills a fontes reais é o que transforma opiniões em análises fundamentadas. Uma skill com dados vence qualquer skill genérica em qualidade de output — 100% das vezes.

WebFetch, signals/trends.json, APIs externas, fontes primárias, dados em tempo real.

A IA deve entender completamente o problema antes de agir. Na prática: sua skill começa com uma seção ## Contexto que define exatamente o que é esperado antes de qualquer instrução de execução.

Skills que pulam a fase de entendimento produzem outputs incorretos 70% mais frequentemente. Um bloco ## Objetivo bem escrito elimina a ambiguidade antes que ela vire retrabalho.

seção ## Contexto, análise prévia, prevenção de erros, claude.md com princípios.

Resolver com a solução mais simples possível. Uma skill de 15 linhas que funciona bate uma de 80 linhas que às vezes falha. Evite seções ## Regras Avançadas que nunca são lidas.

Skills complexas quebram 3x mais durante atualizações e são 5x mais difíceis de depurar. A simplicidade não é limitação — é estratégia de manutenção de longo prazo.

YAGNI (You Aren't Gonna Need It), skill mínima viável, legibilidade sobre elegância, signal-dashboard.md como exemplo.

Ao atualizar uma skill, altere apenas a seção problemática. Se o tom do output está errado, ajuste só a seção ## Tom e Voz — não reescreva o arquivo inteiro.

Mudanças amplas em skills funcionando introduzem regressões invisíveis. Uma edição cirúrgica preserva o que funciona e isola o que precisa mudar, reduzindo o risco de quebrar outputs aprovados.

escopo mínimo de edição, ## Tom e Voz, efeitos colaterais, rastreabilidade de mudanças.

Toda skill deve ter uma seção ## Critérios de Sucesso com condições verificáveis. Exemplo: "O output deve conter título, 3 tópicos e CTA — se faltar qualquer um, a skill falhou."

Sem critérios objetivos, você nunca sabe se uma skill está "boa o suficiente". Com eles, a validação é binária e o ciclo de melhoria fica 10x mais rápido.

## Critérios de Sucesso, definição de done, checklist de validação, memory-os.md para registrar resultados.

O arquivo claude.md na raiz do projeto define regras globais que valem para toda interação. É onde você escreve: "Antes de agir, leia o contexto em context/canal.md" — e isso vale para todas as skills do projeto.

O claude.md é o multiplier: configure uma vez, aplica-se a todas as skills. Sem ele, você repete as mesmas instruções em cada skill — e qualquer atualização precisa ser feita 6 vezes.

claude.md, instrução persistente, configuração global de projeto, princípios automatizados, context/ pasta.

A tradução dos 4 princípios em comportamentos concretos: criar o claude.md com regras Karpathy, montar a pasta context/ com dados do negócio e testar o ciclo completo com uma skill real.

Princípios sem implementação são filosofia. Com o template de claude.md deste módulo, você sai com um projeto configurado e pronto para construir sua primeira super skill.

claude.md template, pasta context/, memory-os.md, checklist de qualidade, fluxo de verificação.

Skills que executam uma tarefa pequena e previsível. Exemplo: formatar-markdown.md que converte texto bruto em Markdown padronizado — entrada e saída sempre iguais, sem necessidade de contexto do negócio.

Confundir utility com super skill é um erro caro: você gasta horas construindo contexto e memória para uma tarefa que não precisa de nada disso — e o resultado não melhora.

formatar-markdown.md, tarefa única, entrada/saída previsível, baixo contexto, alta reprodutibilidade.

Skills com contexto estratégico, dados externos e memória persistente. O signal-dashboard.md é um exemplo: lê tendências de mercado, cruza com dados do seu nicho e gera análise personalizada — impossível de replicar sem seu contexto.

Super skills são ativos que crescem em valor a cada uso. Após 30 execuções, o memory-os.md acumula decisões e preferências que tornam cada output mais preciso — sem esforço adicional seu.

signal-dashboard.md, memory-os.md, contexto estratégico, ativo digital, valor composto.

Pergunta-teste: "Essa tarefa muda de resultado dependendo do meu negócio específico?" Se sim → super skill. Se não → utility skill. É assim que Lucas, Pedro e outros alunos classificam seus inventários no módulo prático.

Usar a ferramenta errada para o problema errado é o maior desperdício do curso. A pergunta-teste elimina a dúvida em menos de 30 segundos para qualquer tarefa.

pergunta-teste de classificação, complexidade da tarefa, dependência de contexto, frequência de uso, valor estratégico.

Exemplos reais do curso: encurtar-url.md via Bitly API, formatar-markdown.md, gerar-alt-text.md para imagens, converter-csv.md. Todos reutilizáveis em qualquer projeto.

Ver exemplos reais calibra o que é uma tarefa adequada para utility skill. No módulo, você ganha uma biblioteca com 8 utility skills prontas para uso imediato.

encurtar-url.md, formatar-markdown.md, Bitly API, automações simples, biblioteca de skills.

Os 6 sistemas construídos no curso: signal-dashboard.md, content-strategy.md, performance-analyzer.md, sponsor-response.md, trend-spotter.md e daily-brief.md.

Ver os 6 sistemas concretos transforma conceito abstrato em objetivo tangível. Carla Mendes triplicou sua produção de conteúdo usando exatamente esses 6 arquivos — sem aumentar horas de trabalho.

signal-dashboard.md, daily-brief.md, memory-os.md, portfólio de skills, automação estratégica.

Um exercício prático onde você lista todas as tarefas repetitivas do seu negócio em inventario-skills.md e aplica a pergunta-teste para classificar cada uma. Pedro completou esse exercício em 45 minutos e identificou 11 candidatas à super skill.

O inventário é o ponto de partida do seu portfólio. Sem ele, você constrói skills ao acaso. Com ele, você prioriza as 3 de maior impacto e começa com as que vão gerar resultado imediato.

inventario-skills.md, mapeamento de processos, priorização por impacto, roadmap de skills, portfólio pessoal.