Em uma frase: instalar uma Skill resume-se, no essencial, a uma única coisa: colocar a pasta da Skill onde a sua ferramenta de IA consegue encontrá-la. O caminho muda conforme o cliente; veja os três métodos de instalação mais comuns.
Antes de instalar, entenda isto: uma Skill é apenas «arquivos + uma pasta». Você não precisa executar nenhum programa para instalá-la: basta copiar os arquivos (ou executar um comando).
Método ①: Claude Code (linha de comando, o mais comum)
Se você é desenvolvedor, o Claude Code é o host de Skills mais comum. Há duas formas de instalar:
Digite-a diretamente (começando com uma barra) na caixa de entrada do Claude Code; ela passa a valer automaticamente após a instalação.
Depois de colocá-la, reinicie o Claude Code (ou abra uma nova sessão) para que a Skill seja reconhecida.
Método ②: Claude Desktop (interface gráfica)
- Abra o Claude Desktop → Settings
- Entre na área Developer
- Procure a configuração do diretório de Skills e aponte o seu diretório local de Skills para onde você guarda as pastas de Skills (por exemplo,
~/skills) - Copie a pasta da Skill para esse diretório → reinicie o Claude Desktop
A interface varia um pouco conforme a versão; deixe-se guiar pelas configurações relacionadas a «Skills» no seu cliente.
Método ③: editores do tipo Cursor / VS Code
- No diretório raiz do seu projeto, use a convenção de diretório de skills do plugin de IA correspondente (por exemplo, o
.cursor/rules/do Cursor ou o caminho oficial de Skills da ferramenta) - Coloque a pasta da Skill nesse diretório
- Recarregue a janela (
Ctrl+Shift+P → Reload Window) para aplicar
A convenção de diretório de Skills de cada IDE muda rápido com as versões; se você não conseguir instalá-la, verifique primeiro a documentação oficial do plugin.
Solução de problemas comuns
| Problema | Causa | Solução |
|---|---|---|
| A IA não a reconhece depois da instalação | Sem reinício / sem nova sessão | Reinicie; confira a grafia do diretório antes de reiniciar |
| A Skill não é ativada | O escopo de ativação da description é muito estreito | Coloque todas as formulações habituais na description (consulte o guia de escrita) |
| Erro «Marketplace not found» | O /plugin só é compatível com esta versão | Atualize o cliente ou use o caminho «colocar o diretório à mão» |
| Você quer desinstalar uma Skill | — | Exclua a pasta ou execute /plugin uninstall |
Como verificar se ela está bem instalada?
- Dê um cenário de ativação diretamente no chat da IA, por exemplo, «me ajuda a escrever um relatório semanal»
- Verifique se a saída segue o formato da Skill (por exemplo, o relatório usa as três seções «resultados / problemas / planos»)
- Se ela não for ativada, verifique o caminho do diretório e a description (os dois pontos de bloqueio mais comuns)
Leituras relacionadas
- Quais instalar: as 10 Skills mais recomendadas
- Escrever a sua: tutorial de criação / guia de escrita
- Usar Skills e MCP juntos: artigo de comparação