Como Instalar Skills para Agentes

Skills são apenas pastas com um arquivo SKILL.md. Instalar uma significa colocar essa pasta no lugar certo para o seu agente. Aqui está onde fica esse lugar para cada ferramenta.

A abordagem universal

Cada agente lê skills de um diretório específico. Existem dois escopos:

Skills de projeto

Ficam dentro do seu repositório. Commitadas no controle de versão. Disponíveis para todos que trabalham naquele projeto.

Skills pessoais

Ficam no seu diretório home. Disponíveis em todos os seus projetos. Só você pode usá-las.

Download e salvar manualmente

A abordagem mais simples — sem necessidade de ferramentas de CLI:

Encontre uma skill no mdskills.ai e clique no botão Download na página de detalhes.
Crie a pasta da skill no seu projeto. Por exemplo, para Claude Code:
mkdir -p .claude/skills/my-skill
Salve o arquivo como SKILL.md dentro dessa pasta:
mv ~/Downloads/SKILL.md .claude/skills/my-skill/
Reinicie seu agente (ou inicie uma nova sessão). A skill está disponível agora.

O nome da pasta se torna o nome da skill. Uma pasta chamada review-pr vira o comando /review-pr em agentes que suportam slash commands.

Onde salvar? Veja o guia por agente abaixo para o caminho de diretório exato da sua ferramenta específica. Resumindo: a maioria dos agentes usa .{agent}/skills/{name}/SKILL.md na raiz do seu projeto.

Instalação rápida com o CLI

A maneira mais rápida de instalar qualquer skill de um repositório no GitHub:

# Install from mdskills.ai

npx mdskills install <skill-name>

# Or use the Vercel CLI

npx skills add <owner>/<repo>

# Or install manually — just clone and copy

git clone https://github.com/owner/skills-repo.git

cp -r skills-repo/my-skill .claude/skills/

As ferramentas de CLI detectam seus agentes instalados e colocam as skills nos diretórios corretos automaticamente. Mas você não precisa de um CLI — copiar a pasta manualmente funciona igualmente bem.

Configuração por agente

Claude Code

Docs

Projeto:.claude/skills/<skill-name>/SKILL.md

Pessoal:~/.claude/skills/<skill-name>/SKILL.md

Claude Code tem o suporte mais completo a skills. As skills aparecem como slash commands — uma skill chamada review-pr vira /review-pr. O Claude também carrega skills automaticamente quando sua solicitação corresponde à descrição de uma skill.

Se você já tem arquivos em .claude/commands/, eles continuam funcionando. Skills são o formato mais novo e suportam recursos extras, como scripts agrupados e configuração por frontmatter.

Claude Code também suporta plugins, que podem agrupar múltiplas skills junto com servidores MCP e outras extensões. Instale plugins via /plugins no CLI.

Cursor

Docs

Projeto:.cursor/skills/<skill-name>/SKILL.md

Pessoal:~/.cursor/skills/<skill-name>/SKILL.md

O Cursor lançou seu marketplace em fevereiro de 2026 com suporte a skills como parte do seu sistema de plugins. Skills são um dos cinco primitivos de plugin, ao lado de servidores MCP, subagentes, hooks e regras.

Você também pode colocar skills em .agents/skills/ — esse caminho é reconhecido por múltiplos agentes e é uma boa escolha se sua equipe usa ferramentas diferentes.

VS Code (Copilot)

Docs

Projeto:.github/skills/<skill-name>/SKILL.md

Pessoal:~/.copilot/skills/<skill-name>/SKILL.md

VS Code suporta skills de agentes por meio do GitHub Copilot. Skills ficam em .github/skills/ para skills de projeto, o que significa que são automaticamente rastreadas no controle de versão junto com seu código.

VS Code também reconhece .claude/skills/ e .agents/skills/. Você pode configurar caminhos de busca adicionais com a configuração chat.agentSkillsLocations.

Digite / no chat do Copilot para ver as skills disponíveis e invocá-las diretamente.

OpenAI Codex

Docs

Projeto:.agents/skills/<skill-name>/SKILL.md

Pessoal:~/.agents/skills/<skill-name>/SKILL.md

O Codex usa o diretório .agents/skills/ por padrão. Esse é o caminho neutro de fornecedor que múltiplos agentes reconhecem, sendo uma escolha segura se você está publicando skills que precisam funcionar em diferentes ferramentas.

Gemini CLI

Docs

Projeto:.gemini/skills/<skill-name>/SKILL.md

Pessoal:~/.gemini/skills/<skill-name>/SKILL.md

O Gemini CLI também lê de .agents/skills/ como fallback. Se você está usando o Gemini CLI especificamente, use o caminho .gemini/skills/. Para compatibilidade entre agentes, use .agents/skills/.

Compatibilidade entre agentes

Se você está publicando uma skill e quer que ela funcione em todo lugar, use o caminho .agents/skills/. A maioria dos agentes verifica esse diretório como fallback. Para skills específicas de projeto onde toda a equipe usa a mesma ferramenta, use o caminho específico do fornecedor.

Dica: Você pode ter a mesma skill em múltiplos diretórios. Algumas equipes criam symlinks de suas skills entre caminhos para que funcionem independentemente do agente que cada pessoa usa. Um simples ln -s resolve.

Verificar se funcionou

Após instalar uma skill, verifique se seu agente consegue vê-la:

Claude Code: Pergunte "Quais skills estão disponíveis?" ou digite / para ver as skills no menu de autocomplete.
VS Code: Digite / no painel de chat do Copilot.
Qualquer agente: Pergunte "Você tem uma skill para [tarefa]?" e veja se ele identifica a descrição.

Se a skill não aparecer, verifique novamente a estrutura de pastas. O diretório deve conter um arquivo SKILL.md (letras maiúsculas e minúsculas importam).

Explorar skills para instalar →Crie a sua própria →Melhores práticas →