skills.sh: o que é o diretório de skills da Vercel e como usar o npx skills

Se você já viu alguém colando npx skills add num tutorial de Claude Code, o comando vem do skills.sh. Ele virou o lugar onde quase todo mundo descobre skill nova, e por isso vale entender o que o ranking mede, como o comando funciona e onde mora o risco. Se você ainda está no começo, o guia de Claude Skills explica o que é uma skill antes.

O que é o skills.sh

O skills.sh tem duas partes. A primeira é o site, um diretório com o ranking das skills, separado em mais instaladas de todos os tempos (All Time), as que mais cresceram nas últimas 24 horas (Trending) e as do momento (Hot). A segunda é o skills, a ferramenta de linha de comando que você roda com npx e que instala a skill no seu agente. Os dois são da Vercel, e o código da ferramenta é aberto, no repositório vercel-labs/skills, com licença MIT.

O ranking não é curadoria: ele é a soma das instalações feitas pelo npx skills, que manda pro site, sem dado pessoal, o nome da skill, os arquivos dela e o horário da instalação. Por isso nenhuma skill pede pra entrar. Ela aparece sozinha quando alguém instala. Em 26 de outubro de 2026, o topo era a Find Skills, com 4,1 milhões de instalações, seguida da Grill Me, do Matt Pocock, com 1,4 milhão.

Como instalar uma skill com npx skills add

Você precisa do Node.js 22.20 ou mais novo no computador. Com ele instalado, o caminho é este:

1. 1Abre o terminal na pasta do seu projeto. Pode ser o terminal do VS Code.
2. 2Roda o npx skills add com o dono e o repositório da skill, como no exemplo abaixo.
3. 3Escolhe, na lista, quais skills do repositório você quer e em quais agentes instalar. A ferramenta acha sozinha os agentes que você tem.
4. 4Escolhe o jeito de instalar: por link (o recomendado, que deixa uma cópia só e facilita atualizar) ou por cópia, pra quando o link não funciona.
5. 5Abre uma conversa nova no Claude Code. A skill vale a partir dali.

Por padrão a skill fica só no projeto. Com -g, ela vale em todos os seus projetos. Pra instalar uma skill só, num agente só, sem a lista de escolha, você diz o nome dela e o agente:

Na página de cada skill, o skills.sh mostra o comando pronto pra copiar, as instalações, as estrelas do repositório, desde quando ele conhece a skill e o resultado das auditorias.

Onde a skill vai parar em cada agente

O npx skills põe a mesma pasta, com o mesmo SKILL.md, no lugar que cada agente lê. Os principais:

É por isso que uma skill feita pro Claude Code funciona no Codex e no Antigravity: o arquivo é o mesmo, só muda a pasta.

Os outros comandos do npx skills

O find é o que mais ajuda quem está começando. Você digita o assunto e ele lista as skills que batem. Dá pra procurar só nos repositórios de uma empresa, como a Vercel:

A Find Skills, a skill que procura skill

A primeira do ranking é uma skill que faz o find por você. Com a Find Skills instalada, quando você pergunta “tem skill pra isso?” ou “como eu faço tal coisa?”, o Claude olha primeiro o ranking do skills.sh e, se não achar, roda a busca. Antes de recomendar, confere três coisas: as instalações (prefere mais de mil e desconfia de menos de cem), quem publicou e as estrelas no GitHub. Só instala se você topar, e se não existir skill pra tarefa, avisa e sugere criar a sua.

Ela é boa porta de entrada, mas lembra do ruído: cada skill instalada a mais pesa em toda conversa. Escolher pelo trabalho que você faz, como eu fiz na lista das melhores skills pro Claude Code, costuma render mais do que instalar tudo que aparece no topo.

As auditorias de segurança do skills.sh

Uma skill roda com o mesmo acesso que o seu agente tem no computador: ela pode mandar o Claude rodar comando, ler arquivo e mexer na internet. Por isso o skills.sh passa cada skill por três auditorias e mostra o resultado de cada uma:

• Gen Agent Trust Hub: aparece como Safe ou com o nível de risco.
• Socket: mostra quantos alertas achou no código.
• Snyk: dá a nota de risco, de baixo (Low Risk) a alto (High Risk).

Alerta não quer dizer que a skill é perigosa. Quer dizer que vale ler o que ela faz antes de instalar. O próprio skills.sh avisa, na documentação, que faz auditoria de rotina mas não garante a segurança de toda skill listada, e pede que você revise antes. Na prática, valem três regras:

• Prefere quem publicou com nome e sobrenome. Skill de empresa (Anthropic, Vercel, Supabase) ou de criador conhecido, com o repositório aberto.
• Abre o `SKILL.md` antes. É texto. Em dois minutos você vê se ela manda rodar algum script estranho ou baixar coisa de fora.
• Nunca põe senha nem chave de API dentro de skill. Se a tarefa precisa falar com outra ferramenta, a ligação certa é por MCP.

Problema com uma skill se reporta no GitHub de quem fez, não no skills.sh. E se você não quer que o npx skills mande a contagem pro ranking, roda com DISABLE_TELEMETRY=1. Isso desliga também os pedidos de auditoria.

skills.sh, plugin do Claude Code ou o shopping?

São três portas pra mesma coisa, e cada uma serve a uma pessoa:

O Shopping de skills é a versão em português do skills.sh: as mesmas skills, puxadas do ranking dele e conferidas no GitHub de cada autor, separadas em corredores pelo trabalho, como design, marketing e documentos. Cada skill tem a página dela, com o resumo em português, quem fez, as instalações e o resultado das três auditorias, e 839 delas ganham a explicação completa: o que ela faz, quando usar e o que pedir depois de instalar. Toda skill de lá é de graça: pra levar, você deixa nome, e-mail e WhatsApp uma vez e cola a frase no Claude Code.

Perguntas sobre o skills.sh

O skills.sh é da Vercel? É. O site e a ferramenta npx skills são da Vercel, e o código da ferramenta é aberto, no repositório vercel-labs/skills.

O skills.sh é grátis? É. A ferramenta é aberta e as skills são publicadas de graça no GitHub por quem fez. O que pode custar é o agente em que você instala, como o Claude Code, que vem a partir do plano Pro, de US$ 20 por mês.

Preciso de conta pra instalar? Não. O npx skills add funciona sem login. Conta na Vercel só é pedida pra criar um pack, que junta várias skills num link só; pra instalar um pack, basta o link.

Como a minha skill entra no ranking? Sozinha. Basta ela estar num repositório público do GitHub e alguém instalar com npx skills add. A contagem sobe a cada instalação. Pra escrever a sua, o passo a passo está em como criar uma skill.

Qual a diferença entre o npx skills e o /plugin do Claude Code? O npx skills põe as pastas das skills em um ou vários agentes. O /plugin instala um pacote fechado só no Claude Code, que pode trazer skills, comandos, conexões MCP e ganchos que rodam sozinhos. O passo a passo dos dois está em como instalar skills no Claude Code.