Agent Mentor Learn
Claude Code Skills: crie seus próprios fluxos de trabalho com IA · Lição 1 de 6

Lição 1: O que são Skills: por que você precisa de fluxos de trabalho personalizados

Objetivos de aprendizado:

  • Entender o problema central que as Skills resolvem
  • Reconhecer quais cenários de trabalho valem a pena automatizar com uma Skill
  • Compreender a mecânica básica de funcionamento das Skills

Pré-requisitos: Você já usou os recursos básicos do Claude Code | Próxima: Lição 2 >>

Você explica o mesmo processo toda vez

Você está usando o Claude Code para organizar as anotações de uma reunião. Você digita: “Pegue esta transcrição de reunião e transforme em tópicos estruturados — separe em decisões, itens de ação e questões em aberto, e marque cada item de ação com um responsável e um prazo.”

O Claude faz. O resultado é bom.

No dia seguinte, outra reunião. Você digita a mesma coisa de novo.

Terceiro dia, quarto dia. Depois de cada reunião você reemite as mesmas instruções. O Claude acerta todas as vezes, mas todas as vezes você precisa explicar do zero.1

É esse o problema que as Skills resolvem: pegar um fluxo de trabalho que você vive explicando e empacotá-lo como uma instrução reutilizável. Escreva uma vez, chame sempre que precisar.2

O que é uma Skill

Uma Skill é um diretório contendo um arquivo SKILL.md que diz ao Claude como executar uma tarefa específica.3

Pense nela como um procedimento escrito que você entrega ao Claude. Você anota os passos com clareza e o Claude trabalha a partir deles. Chega de recomeçar a explicação.4

Por exemplo, o núcleo de uma Skill de anotações de reunião pode ser assim:

Depois de salvar isso, você digita /meeting-notes mais o conteúdo da reunião, e o Claude já sabe o que fazer.1

Quais cenários combinam com Skills

Cenários que combinam com uma Skill compartilham três características:

  1. Repetição: você faz a mesma coisa toda semana, todo dia, às vezes de hora em hora
  2. Passos fixos: o processo pode ser escrito como passos claros, em vez de mudar a cada vez
  3. Verificável: você consegue dizer se o Claude acertou

Casos típicos:

  • Revisão de código (conferir o trabalho contra as convenções do seu time)
  • Conversão de formato de documentos (Markdown para Word, preservando formatações específicas)
  • Análise de logs (extrair o que importa de logs de erro)
  • Geração de casos de teste (transformar a descrição de uma funcionalidade em cenários de teste)
  • Normalização de mensagens de commit (reescrever commits lacônicos no formato acordado pelo time)

Cenários que não combinam com uma Skill:

  • Tarefas pontuais (como “me ajude a desenhar o layout desta página”)
  • Tarefas que exigem muito julgamento humano a cada passagem
  • Trabalho criativo totalmente aberto

Como as Skills funcionam

Quando você cria uma Skill, na prática está fazendo duas coisas:5

  1. Escrevendo o YAML frontmatter (a parte no topo do arquivo delimitada por ---), que diz ao Claude como esta Skill se chama e quando usá-la
  2. Escrevendo as instruções em Markdown (o corpo depois do frontmatter), que diz ao Claude exatamente como executar a tarefa

Duas formas de usar:

  • Invocação manual: você digita /meeting-notes, o Claude carrega as instruções daquela Skill e as executa
  • Acionamento automático: você diz “organize estas anotações de reunião para mim”, o Claude lê as descriptions, decide que a Skill meeting-notes é relevante e a carrega por conta própria6

O acionamento automático só funciona se a description estiver bem escrita. Vamos tratar disso em detalhe na Lição 2.

Onde as Skills ficam

Dois locais:1

  • Skills pessoais: ~/.claude/skills/ — só suas, disponíveis em todos os projetos
  • Skills de projeto: .claude/skills/ — ficam no diretório do projeto, então seus colegas as recebem ao clonar o repositório

Para a sua primeira Skill, comece pelas skills pessoais. Depois de escrever algumas e confirmar que são realmente úteis, mova as que você mais usa para o diretório do projeto, para que o time possa compartilhá-las.

Recapitulação

  • Skills empacotam um fluxo de trabalho repetido como uma instrução reutilizável, para você não reexplicá-lo toda vez
  • Cenários que combinam com uma Skill: repetição, passos fixos, resultados verificáveis
  • Uma Skill é um diretório mais um arquivo SKILL.md contendo YAML frontmatter e instruções em Markdown
  • Duas formas de usar: invocação manual (/skill-name) ou acionamento automático (o Claude decide a partir da description)
  • Dois locais: skills pessoais (~/.claude/skills/) e skills de projeto (.claude/skills/)

Na próxima lição vamos desmontar um arquivo SKILL.md real e ver o que cada parte dele faz.

Lição 2 >>

Footnotes

  1. Documentação oficial do Claude Code: Extend Claude Code with skills — https://code.claude.com/docs/en/skills ↩ ↩2 ↩3

  2. Documentação da plataforma da Anthropic: Agent Skills overview — https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview ↩

  3. Central de ajuda da Anthropic: How to create custom skills — https://support.claude.com/en/articles/12512198-how-to-create-custom-skills ↩

  4. Blog de engenharia da Anthropic: Equipping agents for the real world with Agent Skills — https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills ↩

  5. Claude Skills em profundidade (uma visão a partir dos primeiros princípios) — https://leehanchung.github.io/blogs/2025/10/26/claude-skills-deep-dive/ ↩

  6. Building skills for Claude, na prática: frontmatter YAML e testes — https://sjramblings.io/building-skills-for-claude-part-2/ ↩

Exercícios

01

Revise sua última semana de trabalho e encontre uma tarefa que você explicou ao Claude pelo menos três vezes.

Nível 1: Identificar sua primeira candidata a Skill

Anote:

  1. Qual é a tarefa?
  2. Os passos dela são fixos?
  3. Você consegue dizer se o Claude acertou?
Critérios de conclusão · marcado localmente