No Claude Code, copie a pasta e mantenha o nome
Coloque o diretório em ~/.claude/skills/ ou no .claude/skills/ do projeto, de modo que o nome da pasta continue coincidindo com o campo name dentro do SKILL.md. Escolha o local do projeto se a skill registra regras de um código específico, ou o pessoal se registra o seu jeito de trabalhar. Uma skill no escopo errado não está quebrada, apenas está presente em sessões onde ninguém a queria.
No claude.ai e na API, envie por upload
O claude.ai recebe a pasta da skill como arquivo ZIP pelas configurações de skills, e exige a execução de código ativada, porque é nela que as skills rodam. A API do Claude recebe a skill pelos endpoints /v1/skills; depois cada requisição informa o skill_id no parâmetro container junto com a ferramenta de execução de código, e a skill fica disponível para todo o workspace. As cópias não se sincronizam, então uma alteração feita em uma superfície precisa ser enviada de novo nas outras.
Leia a skill antes de instalar
Uma skill é um conjunto de instruções que o agente vai seguir, e pode trazer scripts que ele tem permissão de rodar. Instalar uma que você não leu é mais parecido com rodar um script de estranho do que com instalar um tema. Veja o que ela manda o agente fazer, veja o que há em scripts/ e prefira skills cuja origem você consegue inspecionar.
Confirme que carregou, não só que copiou
A falha que as pessoas relatam como problema de instalação quase sempre é um nome que não bate com o diretório, ou uma descrição vaga demais para combinar com qualquer tarefa. Peça ao agente exatamente aquilo para o que a skill existe e observe se o comportamento muda. Se nada muda, o problema é a descrição, não o lugar do arquivo.