Skills — Ensinando a Claude a Trabalhar do Seu Jeito

Nos capítulos anteriores, você aprendeu a usar a Claude de forma eficaz: modelos, artefatos, janela de contexto, engenharia de prompt e Projects. Cada uma dessas ferramentas melhora sua interação com a IA. Mas ainda existe um problema: repetição.

Sabe aquele prompt de 500 palavras que você montou com carinho, testou, refinou e ficou perfeito? Na próxima vez que precisar dele, você terá que colar tudo de novo. E se esquecer de um detalhe? A qualidade cai. Se quiser compartilhar com um colega? Precisa enviar o texto cru e torcer para que ele use direito.

As Skills resolvem isso de forma elegante. Uma Skill é essencialmente aquele prompt perfeito empacotado em um módulo reutilizável que a Claude ativa automaticamente quando detecta que é relevante para a tarefa. Você ensina uma vez, e a Claude reproduz para sempre — com a mesma qualidade, toda vez.

Neste capítulo, você vai entender de onde vem o conceito de Skills, como elas funcionam por dentro (a arquitetura de 3 níveis é fascinante), a diferença entre Skills e outras formas de customização, como criar as suas, e 5 exemplos práticos de aplicação. Ao final, você terá um novo superpoder: ensinar a Claude a trabalhar do seu jeito.

O conceito de Skills nasce de um problema fundamental da IA generativa: como dar expertise especializada a um modelo genérico sem sobrecarregá-lo.

Quando você coloca instruções no system prompt de uma conversa ou nas Custom Instructions de um Project, elas são carregadas sempre, em toda mensagem, consumindo tokens da janela de contexto. Isso funciona bem quando você tem poucas instruções. Mas imagine que você quer que a Claude saiba criar apresentações, gerar PDFs, analisar dados médicos, escrever roteiros de vídeo e formatar documentos acadêmicos — tudo ao mesmo tempo. Se todas essas instruções fossem carregadas juntas, ocupariam uma parte enorme da janela de contexto e deixariam pouco espaço para a conversa real.

A solução da Anthropic foi inspirada em como profissionais humanos trabalham: um cirurgião não mantém todos os protocolos de todas as especialidades na memória ativa. Ele tem conhecimento especializado que acessa sob demanda — quando precisa de um protocolo de anestesia regional, consulta o manual específico; quando precisa de farmacologia, consulta outro.

Skills seguem exatamente essa filosofia: são pacotes modulares de expertise que a Claude descobre e carrega sob demanda. Ao invés de carregar tudo o tempo todo, a Claude mantém apenas um índice leve de quais Skills existem e busca as instruções completas apenas quando a tarefa exige.

Essa abordagem tem um nome técnico: Progressive Disclosure (Revelação Progressiva). A informação é entregue em camadas — primeiro os metadados (~100 tokens), depois as instruções (~5.000 tokens), depois recursos adicionais (sob demanda). O resultado é que você pode ter dezenas de Skills instaladas sem penalidade significativa de contexto.

Na documentação oficial da Anthropic, Agent Skills são definidas como "capacidades modulares e reutilizáveis que estendem a funcionalidade do Claude". Cada Skill é um pacote que contém instruções, metadados e recursos opcionais (scripts, templates) que o Claude usa automaticamente quando detecta que são relevantes.

Na prática, uma Skill é uma pasta no filesystem contendo pelo menos um arquivo chamado SKILL.md com instruções em Markdown e um cabeçalho YAML (frontmatter) com nome e descrição.

A distinção mais importante para entender Skills é a diferença entre elas e outras formas de customização no ecossistema Claude:

• Prompt → Descartável, válido só naquela conversa, sempre ocupa contexto, texto livre.
• Custom Instructions (Project) → Persistente dentro de um Project, sempre carregadas em toda conversa do projeto.
• Memória → Persistente entre conversas e Projects, sobre você como usuário.
• Skill → Reutilizável, persiste entre conversas, carregada sob demanda, arquivo estruturado.

A vantagem única das Skills é a combinação de reutilização + carregamento sob demanda. Nenhum outro recurso do ecossistema oferece os dois simultaneamente. Um prompt é descartável; Custom Instructions são sempre carregadas; a Memória é sobre contexto pessoal. Só Skills oferecem expertise especializada que aparece quando necessário e desaparece quando não é.

A arquitetura interna das Skills é um dos designs mais inteligentes do ecossistema Claude. O conteúdo é carregado em 3 níveis progressivos, cada um com custo diferente em tokens:

Nível 1 — Metadados (sempre carregados)

O frontmatter YAML do SKILL.md (campos name e description) é carregado no startup e incluído no system prompt. Custo: ~100 tokens por Skill. Com esse custo mínimo, você pode ter dezenas de Skills instaladas sem penalidade significativa.

---
name: resumo-artigo-cientifico
description: Cria resumos estruturados de artigos científicos com seções padronizadas (objetivo, metodologia, resultados, conclusão, limitações).
---

Nível 2 — Instruções (carregadas quando ativadas)

Quando sua mensagem "casa" com a description de uma Skill, a Claude lê o corpo completo do SKILL.md. Só então as instruções entram na janela de contexto. Custo típico: menos de 5.000 tokens. O SKILL.md funciona como um índice inteligente que contém as instruções principais e pode apontar para arquivos mais detalhados.

Nível 3 — Recursos e Código (conforme necessário)

Arquivos adicionais dentro da pasta da Skill — Markdowns extras, templates, scripts executáveis — são acessados apenas quando referenciados pelo SKILL.md. Scripts são executados, mas o código-fonte nunca entra no contexto — só o output. Custo: efetivamente ilimitado (pago apenas quando acessado).

Exemplo de estrutura de diretório de uma Skill completa:

resumo-artigo/
├── SKILL.md (instruções principais — Nível 2)
├── FORMATO.md (template de formato — Nível 3)
├── EXEMPLOS.md (golden examples — Nível 3)
└── scripts/
    └── formatar_citacoes.py (utilitário — Nível 3)

Na prática, o fluxo funciona assim: (1) No startup, a Claude carrega ~100 tokens de metadados. (2) Quando você pede "resuma este artigo científico", a Claude detecta o match com a description e lê o SKILL.md completo. (3) Se a tarefa exige o template de formato, ela lê o FORMATO.md. Se não, esse arquivo nem é acessado. Cada recurso é carregado apenas quando necessário.

O ecossistema Claude oferece dois tipos de Skills:

Pre-built Skills (da Anthropic)

A Anthropic oferece 4 Skills oficiais prontas para uso, disponíveis para todos os planos no claude.ai:

• PowerPoint (pptx) — Criar apresentações, editar slides, aplicar formatação profissional.
• Excel (xlsx) — Criar planilhas, analisar dados, gerar gráficos.
• Word (docx) — Criar e formatar documentos profissionais.
• PDF (pdf) — Gerar documentos PDF formatados.

No claude.ai, essas Skills já funcionam automaticamente — quando você pede para criar uma apresentação, a Claude ativa a Skill de PowerPoint sem que você precise fazer nada.

Custom Skills (criadas por você)

Skills que você cria para empacotar sua própria expertise ou workflows específicos. As possibilidades são ilimitadas — qualquer processo repetitivo que você faz com a Claude pode ser transformado em uma Custom Skill.

Custom Skills podem ser criadas e instaladas de diferentes formas:

• claude.ai — Upload como arquivo ZIP em Settings > Features (disponível nos planos Pro, Max, Team, Enterprise).
• Claude Code — Crie diretórios com SKILL.md diretamente no filesystem do projeto.
• Claude API — Upload via endpoints para compartilhamento no workspace.

Nem tudo precisa ser uma Skill. Aqui estão os cenários onde Skills fazem mais diferença:

1. Prompt gigante recorrente — Você investiu tempo criando um prompt complexo que produz resultados excelentes? Se vai usá-lo novamente (mesmo que ocasionalmente), empacote como Skill. Você nunca mais vai precisar lembrar de todos os detalhes ou procurar "aquele prompt" no histórico.

2. Workflow repetitivo — Se todo mês você gera o mesmo tipo de relatório, análise, resumo ou conteúdo, uma Skill automatiza o processo. A Claude segue o mesmo pipeline toda vez, com a mesma qualidade.

3. Consistência de formato — Quando o formato de saída precisa ser idêntico sempre — relatórios padronizados, templates de documentos, formatos de conteúdo para redes sociais — a Skill garante que a Claude reproduza o padrão sem variação.

4. Compartilhamento com equipe — Criou uma forma eficaz de usar a Claude para uma tarefa? Empacote como Skill e distribua para colegas. Toda a equipe passa a usar a Claude do mesmo jeito, com o mesmo nível de qualidade.

5. Expertise de domínio — Você tem conhecimento especializado sobre como uma tarefa deve ser executada (regras de formatação acadêmica, protocolos médicos, padrões de código, etc.)? Empacote esse conhecimento em uma Skill para que a Claude siga suas regras de domínio automaticamente.

Por outro lado, não crie uma Skill quando: o prompt é simples e usado poucas vezes (use texto direto), o contexto muda toda vez (use Custom Instructions de Project), ou a informação é sobre você pessoalmente (use Memória).

Criar uma Custom Skill é surpreendentemente simples. Todo o processo leva poucos minutos:

Passo 1 — Criar uma pasta com o nome da skill (use kebab-case, sem espaços):

resumo-artigo-cientifico/

Passo 2 — Criar o arquivo SKILL.md dentro da pasta. Este é o único arquivo obrigatório.

Passo 3 — Escrever o frontmatter YAML (cabeçalho entre ---). Dois campos obrigatórios:

---
name: resumo-artigo-cientifico
description: Cria resumos estruturados de artigos científicos com seções padronizadas: objetivo, metodologia, resultados, conclusão e limitações. Ativada quando o usuário pede para resumir artigos acadêmicos.
---

A description é o campo mais importante — é o que a Claude usa para decidir quando ativar a Skill. Seja específico sobre o tipo de tarefa e quando a Skill deve ser usada.

Passo 4 — Escrever as instruções no corpo do Markdown, abaixo do frontmatter. Use linguagem clara, direta, e estruture com headings:

# Resumo de Artigo Científico

Quando o usuário enviar um artigo, crie um resumo estruturado com:
1. **Objetivo do estudo** — Em 1-2 frases
2. **Metodologia** — Tipo de estudo, amostra, intervenção
3. **Principais resultados** — Dados quantitativos quando disponíveis
4. **Conclusão prática** — Implicações para a prática clínica
5. **Limitações** — Vieses e restrições do estudo

Use linguagem acessível. Palavras-chave em negrito. Mantenha abaixo de 500 palavras.

Passo 5 — Fazer um ZIP da pasta inteira (a pasta, não apenas o arquivo).

Passo 6 — Upload no claude.ai em Settings > Features > Skills > Upload Custom Skill.

Pronto. Na próxima vez que você pedir para resumir um artigo científico, a Claude ativará automaticamente sua Skill e seguirá exatamente o formato que você definiu.

Para inspirar suas próprias criações, aqui estão 5 exemplos de Custom Skills com aplicações reais:

1. Gerador de Questões de Revisão

Cria questões no estilo de provas modernas a partir de qualquer conteúdo. Gera alternativas (A-E), gabarito comentado e classificação por tema e dificuldade. Ideal para estudantes e professores que precisam de banco de questões personalizado.

description: Gera questões de múltipla escolha no estilo de provas de residência médica e concursos, com gabarito comentado. Ativada quando o usuário pede questões, exercícios ou simulados.

2. Criador de Flashcards

Transforma qualquer conteúdo em flashcards no formato pergunta/resposta, com categorização por tema, dificuldade e tags. Pode gerar no formato Anki (importável) ou como artefato visual interativo.

description: Cria flashcards de estudo no formato pergunta-resposta a partir de conteúdo fornecido. Suporta exportação para Anki. Ativada quando o usuário pede flashcards ou cartões de memorização.

3. Roteiro de Vídeo Padronizado

Gera roteiros de vídeo no formato padronizado do seu canal: título + thumbnail, gancho (primeiros 30s), apresentação, ponte, blocos de conteúdo com pattern breaks, CTA intermediária, resumo e CTA final. Inclui notas de produção e checklist de pré-gravação.

description: Cria roteiros de vídeo para YouTube no formato padronizado MedTech, com seções de gancho, conteúdo, CTA e notas de produção. Ativada quando o usuário pede roteiro de vídeo ou script.

4. Analisador de Artigo Científico

Faz análise crítica completa de artigos: avalia metodologia, identifica vieses, verifica adequação estatística, resume contribuições e limitações, e gera uma nota de qualidade baseada em critérios GRADE. Referencia trechos específicos do artigo.

description: Analisa criticamente artigos científicos avaliando metodologia, vieses, estatística e relevância clínica usando critérios GRADE. Ativada quando o usuário pede análise crítica ou avaliação de artigo.

5. Gerador de Conteúdo para Redes Sociais

Transforma qualquer tema em conteúdo formatado para diferentes plataformas: carrosséis para Instagram (10 slides com copy), threads para X/Twitter, posts para LinkedIn, e scripts curtos para Reels/TikTok. Mantém tom de voz, identidade visual e hashtags padronizadas.

description: Cria conteúdo formatado para redes sociais (Instagram, LinkedIn, X, TikTok) a partir de qualquer tema, mantendo identidade visual e tom de voz padronizados. Ativada quando o usuário pede posts, carrosséis ou conteúdo para redes sociais.

Cada um desses exemplos segue o mesmo padrão: uma tarefa repetitiva com formato consistente, onde a qualidade depende de seguir um conjunto específico de regras. É exatamente o tipo de trabalho que Skills automatizam perfeitamente.

A técnica mais poderosa deste capítulo: usar a própria Claude para gerar Skills. É meta — a IA criando instruções para ela mesma seguir — mas funciona extraordinariamente bem.

O pipeline completo:

1. Abra uma conversa com a Claude (fora de qualquer Project específico).
2. Descreva o que você quer que a Skill faça. Seja detalhado: qual a tarefa, qual o formato de saída, quais as regras, qual o público, quando deve ser ativada.
3. Peça para a Claude gerar o SKILL.md completo, incluindo frontmatter YAML e corpo de instruções.
4. Revise o resultado. Ajuste detalhes, adicione exemplos, refine regras.
5. Copie o resultado, salve como arquivo SKILL.md, coloque dentro de uma pasta com nome descritivo.
6. Crie o ZIP e faça upload em Settings > Features > Skills.
7. Teste a Skill com uma tarefa real e refine se necessário.

Dica avançada: você pode dar à Claude um exemplo do output ideal (golden example) e pedir: "Com base neste exemplo, crie uma Skill que gere outputs neste formato." A Claude é excelente em extrair padrões de exemplos concretos e transformá-los em instruções replicáveis.

Outra dica: se você já tem um prompt complexo que funciona bem, cole-o na conversa e peça: "Transforme este prompt em uma Custom Skill com SKILL.md formatado." A Claude faz a conversão automaticamente, incluindo o frontmatter YAML com uma description otimizada.

Skills são, em última análise, a democratização da automação inteligente. Você não precisa ser programador, não precisa entender de APIs, não precisa escrever código. Precisa apenas saber o que quer — e a Claude cuida do resto. Ensine uma vez, use para sempre.