Pular para o conteúdo

Como instalar uma skill no Claude e deixar ela funcionando

Para instalar uma skill no Claude pelo navegador ou pelo aplicativo de computador, compacte a pasta da skill em um arquivo ZIP, abra Customize > Skills (em português, Personalizar > Habilidades), clique no botão "+", escolha criar uma skill e use a opção de enviar arquivo. A skill entra na sua lista e você liga o interruptor ao lado dela. No Claude Code o processo é outro: basta colocar a pasta dentro de ~/.claude/skills/. Abaixo, cada caminho em detalhe e o que fazer quando algo dá errado.

O interruptor que precisa estar ligado antes

Skills rodam no ambiente de execução do Claude, então a criação de arquivos tem que estar ativa. Vá em Settings > Capabilities (Configurações > Recursos) e ligue "Create and edit files" (Criar e editar arquivos). Em versões mais antigas da tela, o nome era "Code execution and file creation". Sem isso, a área de skills fica apagada ou nem aparece.

Sobre planos: a central de ajuda da Anthropic lista skills no Free, Pro, Max, Ultra, Team e Enterprise, enquanto a documentação técnica cita o envio de skills personalizadas no claude.ai a partir do Pro. O teste mais rápido é abrir Customize > Skills na sua conta e ver se o botão "+" está lá.

Instalar no claude.ai e no aplicativo de computador

  1. Confira a pasta: o nome dela tem que ser idêntico ao campo name do SKILL.md, e o SKILL.md precisa estar dentro dela.
  2. Compacte a pasta inteira. No Windows, botão direito sobre a pasta e a opção de compactar em ZIP. No Mac, botão direito e "Comprimir".
  3. Abra Customize > Skills.
  4. Clique em "+", depois em "Create skill" (Criar habilidade) e escolha a opção de upload.
  5. Selecione o ZIP.
  6. Quando a skill aparecer na lista, confira se o interruptor dela está ligado.

Skills enviadas assim ficam privadas na sua conta.

O formato do ZIP que funciona

O erro mais comum é compactar os arquivos em vez da pasta. O ZIP precisa ter a pasta da skill no topo:

[nome-da-skill].zip
└── [nome-da-skill]/
    ├── SKILL.md
    └── references/   (opcional)

Se você abrir a pasta, selecionar o SKILL.md e compactar só ele, o arquivo fica solto na raiz do ZIP e o Claude não reconhece como skill.

Quando o envio dá erro

A central de ajuda aponta quatro causas principais:

  • O ZIP passou do limite de tamanho.
  • O nome da pasta é diferente do nome declarado na skill.
  • O arquivo SKILL.md não está lá.
  • O nome ou a descrição têm caracteres inválidos.

Confira também três armadilhas comuns. O Windows pode ter salvo o arquivo como SKILL.md.txt com a extensão escondida (ative a exibição de extensões no Explorador para ver). O nome pode ter acento, letra maiúscula ou espaço, que não são aceitos. E o cabeçalho pode ter uma linha em branco antes do primeiro ---, o que faz a skill perder nome e descrição.

Instalar no Claude Code

No Claude Code, skills são pastas no seu computador, sem ZIP e sem upload:

  • ~/.claude/skills/[nome-da-skill]/SKILL.md para skills pessoais, que valem em todos os seus projetos.
  • .claude/skills/[nome-da-skill]/SKILL.md dentro de um projeto, para skills que valem só ali e podem ir junto no controle de versão.

Dentro de uma sessão, /skills mostra o que foi carregado e /[nome-da-skill] aciona uma delas diretamente. Mudanças em skills que já existem são percebidas sem reiniciar. Se você criou a pasta de skills depois de abrir a sessão, rode /reload-skills.

Algumas skills chegam como plugin. A documentação usa a skill-creator como exemplo:

/plugin install skill-creator@claude-plugins-official

E se você usa o claude.ai, versões recentes do Claude Code baixam as skills ligadas na sua conta quando você entra com ela. Essa cópia é só de ida: para mudar uma skill sincronizada, edite no claude.ai.

Instalar uma skill baixada da internet

Muita gente encontra skills prontas no GitHub. O processo é o mesmo do ZIP: baixe o material, localize a pasta que contém o SKILL.md, compacte só essa pasta e envie. Antes disso, leia todos os arquivos.

A orientação oficial da Anthropic é usar skills de fontes confiáveis, ou seja, criadas por você ou pela própria Anthropic. Uma skill pode carregar instruções e scripts, e uma skill mal-intencionada pode levar o Claude a enviar seus dados para fora ou executar algo que não tem nada a ver com o propósito declarado. Desconfie de scripts que você não entende e de instruções que mandam acessar endereços externos. Trate como instalar um programa.

Em plano de equipe

No plano Team, skills vêm habilitadas por padrão. No Enterprise, quem administra precisa ligar o recurso em Organization settings > Plugins & skills, na aba Policy. Depois, cada pessoa liga as suas em Customize > Skills. Para compartilhar uma skill com colegas, use o menu de três pontos ao lado dela e a opção de compartilhar. Quem recebe pode usar, mas não editar.

Conferindo se deu certo

Abra uma conversa nova e faça um pedido que combine com a skill, sem citar o nome dela. Resultado no formato da skill: está ativa. Resultado genérico: revise a descrição primeiro.

O ebook "Skills de IA" cobre o caminho inteiro, da escrita do primeiro SKILL.md à instalação pelos três caminhos, com checklist de verificação, seis skills prontas para instalar e uma lista de erros comuns com a correção de cada um.