O que é uma skill, em uma frase?

É um pacote de instruções que estende o que o Claude Code sabe fazer: um procedimento, checklist ou método, escrito uma vez, que o agente usa quando a tarefa combina. É como ensinar uma nova habilidade à ferramenta, sem tocar no código dela.

Qual a diferença entre uma skill e o CLAUDE.md?

O CLAUDE.md guarda fatos que valem para toda sessão e são carregados sempre. A skill guarda procedimentos que só importam em tarefas específicas e são carregados sob demanda. Fato permanente e leve fica no CLAUDE.md; procedimento reutilizável e ocasional vira skill, para não pesar o contexto.

Quando vale a pena criar uma skill?

Quando você repete as mesmas instruções, o mesmo checklist ou o mesmo procedimento de vários passos, ou quando uma seção do CLAUDE.md virou um procedimento longo. Também quando tem um jeito próprio de fazer algo que quer garantir sempre igual. O sinal é a repetição de um passo a passo.

Skills e comandos personalizados são a mesma coisa?

Os comandos personalizados são a forma mais simples de skill, como você viu no módulo de comandos. Uma skill completa vai além, com recursos como arquivos de apoio e acionamento automático pelo agente. O que você aprendeu sobre comandos é a base; este módulo aprofunda o resto.

Preciso criar skills para usar o Claude Code?

Não. A ferramenta funciona muito bem sem nenhuma skill sua, e já vem com algumas prontas. Criar as suas é opcional e serve para especializar o agente nos seus procedimentos. Comece entendendo o conceito e crie skills quando perceber que está repetindo um passo a passo com frequência.

Módulo 11 - Skills

O que é uma skill

8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026

O que você vai aprender

Explicar o que é uma skill.
Entender que ela estende o que o agente sabe fazer.
Reconhecer quando vale criar uma skill.
Diferenciar uma skill de uma instrução avulsa.

Instruções empacotadas que o agente usa

No módulo de comandos, você teve uma primeira prova das skills, quando descobriu que criar um comando personalizado era criar uma skill simples. Agora vamos ao conceito completo. Uma skill é um pacote de instruções que estende o que o Claude Code sabe fazer. Imagine que você tem um jeito específico de fazer algo, um procedimento de revisão, um checklist de segurança, um formato de relatório, um passo a passo para resolver um tipo de problema. Em vez de reexplicar isso toda vez, você empacota essas instruções numa skill. A partir daí, o Claude Code passa a saber fazer aquilo do seu jeito, como se você tivesse ensinado uma nova habilidade a ele.

A diferença entre uma skill e uma instrução avulsa está na organização e na reutilização. Você poderia digitar o seu checklist de segurança a cada revisão, mas isso é trabalhoso e inconsistente. Você poderia colocá-lo no arquivo de memória do projeto, mas, se for um procedimento longo que só importa às vezes, ele pesaria no contexto de toda sessão sem necessidade. A skill resolve os dois problemas: guarda o procedimento num pacote próprio e o traz à tona só quando é relevante. É o lugar certo para o conhecimento que é procedimental, ou seja, um passo a passo, e não apenas um fato, e que não precisa estar presente o tempo todo.

Diagrama mostrando um pacote de instruções (uma skill) com um procedimento passo a passo dentro, sendo entregue ao Claude Code como uma nova habilidade. Ao lado, a comparação com reexplicar as mesmas instruções toda vez, ilustrando o ganho de empacotar uma vez e reutilizar. — A skill empacota um procedimento uma vez; o agente ganha essa habilidade e a usa quando cabe.

Quando vale criar uma skill

Há um sinal claro de que uma skill é a resposta: você se pega colando as mesmas instruções, o mesmo checklist ou o mesmo procedimento de vários passos na conversa, repetidamente. Ou percebe que uma parte do seu arquivo de memória cresceu e virou um procedimento, não mais um simples fato. Nesses momentos, aquilo pede uma skill. Outro sinal é ter um jeito próprio de fazer algo que você quer garantir sempre igual: um formato de documentação, um estilo de teste, uma sequência de verificação antes de entregar. Empacotar isso numa skill transforma um hábito manual e inconsistente numa habilidade confiável do agente.

Sinal	O que fazer
Você cola o mesmo checklist toda vez	Vira skill
Uma seção do CLAUDE.md virou um procedimento longo	Move para uma skill
Um passo a passo que só importa às vezes	Vira skill (não pesa o contexto sempre)
Um fato simples que vale para toda sessão	Fica no CLAUDE.md, não vira skill

Skill é para procedimento reutilizável e sob demanda; fato permanente e leve fica no CLAUDE.md.

🎮 Jogo da aula

Vira skill ou não?

Classifique cada item conforme ele pede uma skill ou se encaixa melhor em outro lugar.

Repare que a skill se distingue do CLAUDE.md justamente pela natureza do conteúdo. O CLAUDE.md guarda fatos que valem para toda sessão, e por isso são carregados sempre. A skill guarda procedimentos que só importam quando uma tarefa específica aparece, e por isso são carregados sob demanda. Essa distinção, fato permanente contra procedimento sob demanda, é a chave para decidir onde cada coisa mora. Colocar um procedimento longo no CLAUDE.md o faria pesar em todas as sessões sem necessidade; deixá-lo numa skill o mantém disponível sem custo até a hora de usar. É uma questão de colocar cada conhecimento no lugar que respeita o contexto limitado do modelo.

Skills como superpoderes sob medida

Uma forma bonita de pensar nas skills é como superpoderes sob medida que você concede ao Claude Code. Cada skill é uma habilidade nova, específica do seu contexto, que o agente não tinha empacotada. Uma pessoa cria uma skill para gerar documentação no padrão da empresa; outra, para analisar um tipo de dado do seu jeito; outra, para seguir um protocolo de resposta a incidentes. São capacidades que nascem da necessidade real de cada um, e que transformam o Claude Code de uma ferramenta genérica numa que fala a sua língua e segue os seus métodos. Quanto mais você usa a ferramenta, mais oportunidades de skill você enxerga.

Vale saber que as skills seguem um padrão aberto, o que significa que a ideia não é exclusiva do Claude Code e que skills podem ser compartilhadas e reaproveitadas. Isso abre um mundo: além de criar as suas, você pode se beneficiar de skills feitas por outras pessoas e pela comunidade, um tema que toca os plugins, mais adiante. Por ora, o importante é entender o conceito: a skill é o mecanismo oficial de estender o Claude Code com habilidades novas, empacotadas e reutilizáveis, sem tocar no código da ferramenta. As próximas aulas mostram como elas são descobertas, como criar as suas e como enriquecê-las.

Teste rápido

O que é uma skill no Claude Code?

Perguntas frequentes

O que é uma skill, em uma frase?: É um pacote de instruções que estende o que o Claude Code sabe fazer: um procedimento, checklist ou método, escrito uma vez, que o agente usa quando a tarefa combina. É como ensinar uma nova habilidade à ferramenta, sem tocar no código dela.
Qual a diferença entre uma skill e o CLAUDE.md?: O CLAUDE.md guarda fatos que valem para toda sessão e são carregados sempre. A skill guarda procedimentos que só importam em tarefas específicas e são carregados sob demanda. Fato permanente e leve fica no CLAUDE.md; procedimento reutilizável e ocasional vira skill, para não pesar o contexto.
Quando vale a pena criar uma skill?: Quando você repete as mesmas instruções, o mesmo checklist ou o mesmo procedimento de vários passos, ou quando uma seção do CLAUDE.md virou um procedimento longo. Também quando tem um jeito próprio de fazer algo que quer garantir sempre igual. O sinal é a repetição de um passo a passo.
Skills e comandos personalizados são a mesma coisa?: Os comandos personalizados são a forma mais simples de skill, como você viu no módulo de comandos. Uma skill completa vai além, com recursos como arquivos de apoio e acionamento automático pelo agente. O que você aprendeu sobre comandos é a base; este módulo aprofunda o resto.
Preciso criar skills para usar o Claude Code?: Não. A ferramenta funciona muito bem sem nenhuma skill sua, e já vem com algumas prontas. Criar as suas é opcional e serve para especializar o agente nos seus procedimentos. Comece entendendo o conceito e crie skills quando perceber que está repetindo um passo a passo com frequência.

Fontes

Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.

← Subagentes na prática e o que vem além Concluir e avançar →