Skills do Claude: o que são e como instalá-las
Uma skill é uma pasta de instruções que o Claude carrega somente quando precisa delas. Veja onde ela fica, como instalá-la e como ela difere do MCP.
Uma skill do Claude é uma pasta que contém um SKILL.md arquivo com instruções e, opcionalmente, scripts e arquivos de referência. O Claude lê a descrição, decide se a skill é relevante e só então carrega o restante. As skills do Claude Code funcionam da mesma forma e são invocadas com /skill-name. As skills seguem o padrão aberto Agent Skills, então o mesmo arquivo também funciona em outras ferramentas de AI.
Skills do Claude versus MCP, plugins e projetos
Esses quatro são constantemente confundidos, e escolher o errado é o motivo pelo qual as pessoas acabam instalando algo que nunca é acionado. A diferença não está no que eles contêm. Está em quando o Claude os carrega e qual trabalho eles realizam.
| O que fornece ao Claude | Quando é carregado | Use para | |
|---|---|---|---|
| Skill | Um procedimento - como realizar uma tarefa | Sob demanda, quando relevante | Trabalho repetível: um formato de relatório, uma lista de verificação de revisão, um estilo próprio |
| MCP | Acesso a uma ferramenta ou fonte de dados externa | Quando a ferramenta é chamada | Acessar Jira, Slack, um banco de dados, um armazenamento de arquivos |
| Plugin | Um pacote: skills, Agents, hooks, servidores MCP | Quando o plugin está habilitado | Distribuir um fluxo de trabalho completo como uma única unidade instalável |
| Projeto | Conhecimento de base estático | Sempre, em todos os chats daquele projeto | Contexto que nunca pode faltar |
- O MCP fornece as ferramentas ao Claude. Uma skill ensina o Claude a usá-las. Eles se complementam.
- Um projeto é sempre carregado. Uma skill só é carregada quando corresponde à tarefa.
- As instruções personalizadas se aplicam a todas as conversas. Uma skill se aplica a um tipo de trabalho.
Onde ficam as skills do Claude Code
No Claude Code, uma skill é um diretório no disco. O local onde você coloca esse diretório determina quem pode usá-la. Existem quatro locais, que são resolvidos em uma ordem fixa quando duas skills têm o mesmo nome.
| Localização | Caminho | Aplica-se a |
|---|---|---|
| Empresarial | Definido nas configurações gerenciadas | Todas as pessoas da organização |
| Pessoal | ~/.claude/skills/<skill-name>/SKILL.md |
Todos os seus projetos |
| Projeto | .claude/skills/<skill-name>/SKILL.md |
Somente aquele projeto |
| Plugin | <plugin>/skills/<skill-name>/SKILL.md |
Onde quer que o plugin esteja habilitado |
Quando duas skills têm o mesmo nome, a empresarial prevalece sobre a pessoal, e a pessoal prevalece sobre a do projeto. As skills de plugins recebem o namespace /plugin-name:skill-name, então elas nunca colidem. O Claude Code monitora essas pastas e detecta uma edição dentro da sessão - sem reiniciar.
O erro que quase todo mundo comete
As sessões do Cowork e da nuvem não leem ~/.claude/skills/ na sua máquina.
Elas carregam as Skills habilitadas para sua conta do claude.ai, sincronizadas quando a sessão começa. Uma Skill que existe apenas na sua pasta local voltará como “skill not found” nesse ambiente. Para usá-la no Cowork, habilite-a para sua conta.
Como instalar uma Skill do Claude
Três ambientes, três caminhos diferentes. Escolha o que você realmente usa. Cada um leva menos de dois minutos e nenhum exige escrever código.
Claude (claude.ai e Desktop)
- Abra Customize na sua conta e selecione Skills.
- Clique em + e carregue sua própria pasta
SKILL.mdou clique em Browse skills para abrir o diretório. - Ative a Skill.
- Inicie um chat e descreva a tarefa. O Claude carrega a Skill quando ela corresponde à solicitação.
Requer que a execução de código esteja habilitada na sua conta. Disponível nos planos Free, Pro, Max, Team e Enterprise.
Claude Code
- Crie a pasta:
~/.claude/skills/minha-skill/para todos os projetos, ou.claude/skills/minha-skill/para um repositório. - Coloque
SKILL.mddentro dela. - Digite
/minha-skillna sua sessão ou apenas descreva a tarefa e deixe o Claude escolhê-la.
Não é necessário reiniciar. O Claude Code monitora essas pastas e detecta as alterações em tempo real.
Cowork
- Habilite a Skill para sua conta do claude.ai — selecione Customize na barra lateral do Desktop ou acesse as configurações de Skills no claude.ai.
- Inicie uma sessão do Cowork. As Skills da sua conta são sincronizadas no início da sessão.
- Invoque-a pelo nome ou deixe o Claude escolhê-la.
As sessões na nuvem também carregam as Skills do projeto enviadas para o repositório .claude/skills/ pasta.
O que realmente há dentro de um arquivo SKILL.md
Uma Skill é um arquivo Markdown com um pequeno cabeçalho YAML. Esse é todo o formato. Se você consegue escrever uma lista de verificação em um editor de texto, consegue criar uma Skill.
--- nome: relatório-trimestral descrição: Cria nosso relatório trimestral de receita a partir de uma exportação CSV bruta when_to_use: Quando alguém solicitar o relatório trimestral ou fornecer uma exportação de receita ferramentas permitidas: Ler Grep --- ## Etapas 1. Leia o CSV e verifique se os cabeçalhos das colunas correspondem ao esquema esperado. 2. Agrupe a receita por linha de produto e, depois, por mês. 3. Sinalize qualquer mês que tenha variado mais de 15% em relação ao anterior. 4. Escreva o resumo no formato abaixo.
when_to_use.Tudo abaixo do cabeçalho são apenas instruções escritas com suas próprias palavras. Sem SDK, sem etapa de compilação, sem implantação.
Usando Skills do Claude Cowork
O Cowork executa o Claude sobre seus arquivos e tarefas, em vez de dentro de uma janela de chat, e as Skills são como você informa o que significa “feito corretamente” para sua equipe. A regra que confunde as pessoas: o Cowork não lê a pasta de Skills no seu computador. Tanto as sessões interativas quanto as agendadas do Cowork carregam as Skills habilitadas para sua conta do claude.ai, sincronizadas quando a sessão começa.
Portanto, o fluxo de trabalho é: escreva a skill uma vez, ative-a para sua conta e ela acompanhará você em todas as sessões do Cowork e em todas as execuções agendadas.
Agent Skills da Anthropic: um padrão aberto, sem aprisionamento
A especificação Agent Skills é publicada como um padrão aberto em agentskills.io, com um SDK de referência em Python para qualquer pessoa que implemente suporte a skills em sua própria plataforma. O Claude Code segue o padrão e adiciona suas próprias extensões - controle de invocação, execução de subagentes e injeção dinâmica de contexto.
A consequência prática é a parte que vale a pena ler duas vezes: uma skill que você escreve hoje é um arquivo Markdown regido por uma especificação pública. Se você mudar para outra ferramenta de AI que adote o padrão, o arquivo vai com você.
Quando uma skill não é acionada
A skill nunca é acionada
Nove vezes em dez, o problema está na descrição, não nas instruções. O Claude lê apenas a descrição para decidir. Reescreva-a para começar com o caso de uso concreto e adicione when_to_use com as frases que as pessoas realmente digitam.
A skill é acionada com frequência demais
A descrição é ampla demais. Restrinja-a à situação específica ou defina disable-model-invocation: true para que ela seja executada somente quando você digitar /skill-name por conta própria.
Funciona localmente, mas não no Cowork nem em uma execução agendada
Ela está em ~/.claude/skills/ e em nenhum outro lugar. Essas sessões começam do zero e carregam as skills da sua conta do claude.ai. Ative-a para sua conta ou faça commit dela no repositório em .claude/skills/ para sessões na nuvem.
Skills do Claude: perguntas frequentes
O que é uma skill do Claude?
Uma pasta que contém um arquivo SKILL.md com instruções e, opcionalmente, scripts e arquivos de referência. O Claude lê a descrição da skill, decide se ela é relevante para sua solicitação e só então carrega as instruções completas. Isso é chamado de divulgação progressiva e explica por que ter muitas skills instaladas não preenche a janela de contexto.
Onde ficam as skills do Claude Code?
As skills pessoais ficam em ~/.claude/skills/<skill-name>/SKILL.md e se aplicam a todos os projetos. As skills do projeto ficam em .claude/skills/<skill-name>/SKILL.md dentro do repositório e se aplicam somente a esse projeto. Os plugins incluem skills em <plugin>/skills/<skill-name>/SKILL.md, e as skills empresariais são definidas por meio de configurações gerenciadas.
Qual é a diferença entre as skills do Claude e o MCP?
O MCP conecta o Claude a serviços externos e fontes de dados - ele fornece as ferramentas. Uma skill fornece conhecimento procedural: as instruções para executar uma tarefa corretamente. Elas são complementares, não alternativas. Um conector MCP dá ao Claude acesso ao seu Jira; uma skill informa ao Claude como sua equipe escreve um ticket.
Como instalo uma skill do Claude?
No claude.ai, abra Customize, depois Skills, clique em + e carregue a skill ou procure no diretório. No Claude Code, coloque a pasta da skill em ~/.claude/skills/ ou em .claude/skills/ do projeto e invoque-a com /skill-name. No Cowork, ative a skill para sua conta do claude.ai, e ela será sincronizada no início da sessão.
As skills do Claude funcionam no Cowork?
Sim, mas não a partir da sua pasta local. As sessões do Cowork, tanto interativas quanto agendadas, carregam as skills ativadas para sua conta do claude.ai, e não de ~/.claude/skills/ no seu computador. Ative a skill para sua conta em Personalizar, na barra lateral do Desktop, ou nas configurações de skills do claude.ai.
Preciso saber programar para escrever uma skill?
Não. Uma skill é um arquivo Markdown com um breve cabeçalho YAML - nome, descrição e suas instruções em linguagem simples. Scripts são opcionais e só são necessários para comportamentos avançados. Se você consegue escrever uma lista de verificação, consegue escrever uma skill.
As skills do Claude são gratuitas?
O recurso está disponível nos planos Free, Pro, Max, Team e Enterprise e exige que a execução de código esteja ativada. As skills próprias da Anthropic, como as de criação de documentos para Word, Excel e PowerPoint, estão disponíveis para todos os usuários. As skills que você compra ou baixa têm o preço definido por quem as criou.
É seguro instalar uma skill escrita por outra pessoa?
Uma skill é um conjunto de instruções que o Claude seguirá, então leia-a como você leria um script antes de executá-lo. Nos planos Enterprise, as organizações podem ativar a verificação de skills e plugins para checar se os uploads contêm conteúdo malicioso. Para todo o resto, vale a regra de sempre: instale a partir de fontes que você consiga identificar.
O que são as Agent Skills da Anthropic?
Agent Skills é a especificação aberta por trás do formato, publicada em agentskills.io com um SDK de Python de referência. Isso significa que uma skill não está vinculada ao Claude - qualquer plataforma que adote o padrão pode ler o mesmo arquivo SKILL.md. A Anthropic também publica suas próprias skills mantidas, que o Claude invoca automaticamente quando são relevantes.
Qual é a diferença entre uma skill e um projeto do Claude?
Um projeto fornece conhecimento de contexto estático que é carregado em todos os chats dentro dele. Uma skill fornece um procedimento que é ativado somente quando a tarefa corresponde, e funciona em qualquer lugar, em vez de ficar dentro de um único projeto. Use um projeto para o contexto que precisa estar sempre presente e uma skill para trabalhos que você repete.
Não quer escrever uma?
Mais de 1.000 skills, já escritas e testadas.
Arquivos de skills específicos para cada função, para Claude, ChatGPT e qualquer chat de AI - contador, estrategista de SEO, escriba médico, engenheiro de plataforma. Escritos e testados por nós, não extraídos do GitHub. Baixe, coloque na pasta e pronto. Preço único, sem assinatura.