Skills do Claude: o que são e como instalá-las
Uma Skill é uma pasta de instruções que o Claude carrega apenas quando precisa delas. Veja onde ela fica, como instalá-la e como ela difere do MCP.
Uma Skill do Claude é uma pasta contendo 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 vs 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á ativado | Distribuição de um fluxo de trabalho completo como uma unidade instalável |
| Projeto | Conhecimento de fundo estático | Sempre, em todas as conversas desse projeto | Contexto que nunca pode faltar |
- O MCP fornece as ferramentas ao Claude. Uma skill ensina o Claude a usá-las. Elas 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, e eles são resolvidos em uma ordem fixa quando duas skills têm o mesmo nome.
| Local | Caminho | Aplica-se a |
|---|---|---|
| Empresarial | Definida nas configurações gerenciadas | Todos na organização |
| Pessoal | ~/.claude/skills/<skill-name>/SKILL.md |
Todos os seus projetos |
| Projeto | .claude/skills/<skill-name>/SKILL.md |
Somente esse projeto |
| Plugin | <plugin>/skills/<skill-name>/SKILL.md |
Onde quer que o plugin esteja ativado |
Quando duas skills têm o mesmo nome, a empresarial tem prioridade sobre a pessoal, e a pessoal tem prioridade sobre a do projeto. As skills de plugins são identificadas por namespace como /plugin-name:skill-name, portanto elas nunca entram em conflito. O Claude Code monitora essas pastas e identifica 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 ativadas para sua conta do claude.ai, sincronizadas quando a sessão começa. Uma skill que existe apenas na sua pasta local aparecerá como “skill não encontrada” lá. Para usá-la no Cowork, ative-a para sua conta.
Como instalar uma skill do Claude
Três interfaces, três caminhos diferentes. Escolha a que você realmente usa. Cada uma leva menos de dois minutos e nenhuma exige escrever código.
Claude (claude.ai e Desktop)
- Abra Personalizar na sua conta e selecione Skills.
- Clique em + e carregue sua própria pasta
SKILL.mdou clique em Procurar skills para abrir o diretório. - Ative a skill.
- Inicie um chat e descreva a tarefa. O Claude carrega a skill quando ela corresponde à tarefa.
Requer que a execução de código esteja ativada na sua conta. Disponível nos planos Free, Pro, Max, Team e Enterprise.
Claude Code
- Crie a pasta:
~/.claude/skills/my-skill/para todos os projetos ou.claude/skills/my-skill/para um repositório. - Solte
SKILL.mddentro dela. - Digite
/my-skillna sua sessão ou simplesmente descreva a tarefa e deixe o Claude executá-la.
Não é necessário reiniciar. O Claude Code monitora essas pastas e identifica as alterações em tempo real.
Cowork
- Ative a skill para sua conta do claude.ai - personalize na barra lateral do Desktop ou nas configurações de skills do 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 incluídas no repositório .claude/skills/ pasta.
O que há de fato dentro de um arquivo SKILL.md
Uma skill é 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 escrever uma skill.
--- name: quarterly-report description: Cria nosso relatório de receita trimestral a partir de uma exportação CSV bruta when_to_use: Quando alguém solicitar o relatório trimestral ou entregar uma exportação de receita allowed-tools: Read 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 nos seus arquivos e tarefas, em vez de dentro de uma janela de chat, e as skills são como você informa o que significa “concluído corretamente” para sua equipe. A regra que confunde as pessoas: o Cowork não lê a pasta de skills na sua máquina. Tanto as sessões interativas quanto as agendadas do Cowork carregam as skills ativadas para sua conta do claude.ai, sincronizadas quando a sessão é iniciada.
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 quem estiver implementando suporte a skills em sua própria plataforma. 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ê migrar 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.
O skill é acionado com frequência demais
A descrição é ampla demais. Restrinja-a à situação específica ou defina disable-model-invocation: true para que ele seja executado somente quando você digitar /skill-name por conta própria.
Funciona localmente, mas não no Cowork ou em uma execução agendada
Ele está em ~/.claude/skills/ e em nenhum outro lugar. Essas sessões começam do zero e carregam os Skills da sua conta do claude.ai. Habilite-o para sua conta ou faça commit dele no repositório .claude/skills/ para sessões na nuvem.
Skills do Claude: perguntas frequentes
O que é um 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 do 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 é por isso que ter muitos Skills instalados não ocupa toda a janela de contexto.
Onde ficam os Skills do Claude Code?
Os Skills pessoais ficam em ~/.claude/skills/<skill-name>/SKILL.md e se aplicam a todos os projetos. Os Skills de 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 os Skills empresariais são definidos por meio de configurações gerenciadas.
Qual é a diferença entre os Skills do Claude e o MCP?
O MCP conecta o Claude a serviços externos e fontes de dados - ele fornece as ferramentas. Um skill fornece conhecimento procedural: as instruções sobre como realizar uma tarefa corretamente. Eles são complementares, não alternativas. Um conector MCP dá ao Claude acesso ao seu Jira; um skill diz ao Claude como sua equipe escreve um ticket.
Como instalo um skill do Claude?
No claude.ai, abra Personalizar, depois Skills, clique em + e carregue o skill ou navegue pelo diretório. No Claude Code, coloque a pasta do skill em ~/.claude/skills/ ou em .claude/skills/ do projeto e invoque-o com /skill-name. No Cowork, habilite o skill para sua conta do claude.ai, e ele será sincronizado no início da sessão.
Os Skills do Claude funcionam no Cowork?
Sim, mas não a partir da sua pasta local. As sessões do Cowork, sejam interativas ou agendadas, carregam os Skills habilitados para sua conta do claude.ai, e não os de ~/.claude/skills/ na sua máquina. Habilite o 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 um skill?
Não. Uma skill é um arquivo Markdown com um breve cabeçalho YAML - nome, descrição e suas instruções em linguagem simples. Os 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 habilitada. As próprias skills 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 contém instruções que o Claude seguirá, então leia-a como você leria um roteiro antes de executá-lo. Nos planos Enterprise, as organizações podem ativar a verificação de skills e plugins para conferir se os uploads contêm conteúdo malicioso. Para todo o resto, vale a regra de sempre: instale apenas 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 referência em Python. 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 estático de contexto, 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 dentro de um único projeto. Use um projeto para o contexto que deve estar sempre presente e uma skill para o trabalho que você repete.
Não quer escrever uma?
Mais de 2.400 skills, prompts e agents, já escritos e testados.
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 coletados do GitHub. Baixe, coloque na pasta e pronto. Preço único, sem assinatura.