SKILL 58 · AGENT SKILL
Find Skills
Ajuda o agente a transformar uma necessidade em opções de Skills pesquisáveis, comparar adoção e origem e só então oferecer a instalação.
FONTE PRIMÁRIA
Confira o projeto original.
A imagem é uma ilustração editorial exclusiva. A origem, a licença e as permissões devem ser conferidas no repositório oficial antes da instalação.
Abrir repositório original ↗
O QUE ESTA SKILL VERIFICA
O que ela coloca na mesa.
✓Pesquise sem nomes de clientes, caminhos internos ou dados sensíveis
✓Confirme origem, licença, pasta e arquivos antes de recomendar
✓Instale primeiro por projeto e mantenha confirmação e revisão humana
✓Audite permissões e efeitos da Skill escolhida antes do primeiro uso
DETALHES DA SKILL
Como esta skill funciona na prática.
Entenda a função, o melhor cenário de uso e o resultado que você deve revisar antes de incluir esta skill no seu fluxo de trabalho.
Quando ela é útil
Pedidos em que uma capacidade especializada pode existir como Agent Skill e precisa ser descoberta antes de instalar ou improvisar.
O que ela faz
Ajuda o agente a transformar uma necessidade em opções de Skills pesquisáveis, comparar adoção e origem e só então oferecer a instalação.
O que você deve receber
Lista curta com nome, origem, instalações observadas, comando e link para auditoria, mantendo a decisão de instalar com o usuário.
Onde pode ser usada
Codex, Claude Code, Gemini CLI, Cursor, GitHub Copilot e outros agentes listados pelo Skills CLI; a versão auditada exige Node.js 22.20.0 ou mais recente.
Limite importante
A instrução orienta consultas em skills.sh e pode levar ao fluxo de instalação, que baixa repositórios e grava arquivos. Termos pesquisados saem do ambiente; o Skills CLI declara telemetria adicional habilitada por padrão, desativável com DISABLE_TELEMETRY=1 ou DO_NOT_TRACK=1.
ANÁLISE EDITORIAL
Find Skills é uma Agent Skill para descobrir capacidades reutilizáveis antes de improvisar uma solução do zero. Ela orienta o agente a entender o pedido, pesquisar o catálogo público do ecossistema, comparar origem e adoção, apresentar opções verificáveis e só então oferecer a instalação. O valor não está em encontrar o primeiro resultado, mas em separar descoberta de decisão.
A versão auditada pertence ao repositório vercel-labs/skills, commit c6f69c6. Em 13 de agosto de 2026, às 12:04 no fuso America/Sao_Paulo, a API pública do GitHub registrava 28.808 estrelas. O repositório usa licença MIT e o Skills CLI declarava a versão 1.5.22.
Imagem editorial exclusiva do Bastidores da IA. Não é captura de tela, interface real nem prova de que uma Skill foi aprovada.
O que esta Skill faz de verdade
O SKILL.md auditado define um roteiro de seis etapas. O agente identifica domínio e tarefa, consulta primeiro o catálogo, pesquisa por termos específicos, verifica qualidade, apresenta as opções com origem e comando e pergunta se o usuário quer instalar. Quando nada adequado aparece, a instrução manda reconhecer a ausência e continuar ajudando com as capacidades gerais.
A busca oficial é feita com npx skills find [consulta]. No código da versão auditada, o CLI envia a consulta para https://skills.sh/api/search, limita a resposta a 20 itens e ordena os resultados pelo número de instalações. O parâmetro --owner restringe a pesquisa a um usuário ou organização do GitHub e aceita apenas um identificador compatível com o formato de owner.
Há uma diferença importante entre os modos. Com uma consulta explícita, o CLI lista resultados e comandos sugeridos. Sem consulta, em um terminal interativo, ele abre um seletor e pode encaminhar a opção escolhida para o fluxo de instalação. Dentro de um agente ou terminal não interativo, o comando sem consulta apenas imprime instruções de uso. Por isso, uma busca específica é mais previsível para a primeira avaliação.
Para quem serve
A Skill serve para pessoas e equipes que usam Codex, Claude Code, Gemini CLI, Cursor, GitHub Copilot ou outro agente compatível com o padrão de Agent Skills e precisam encontrar um fluxo especializado. Exemplos incluem revisão de código, testes, documentação, design, implantação, pesquisa e automação.
Ela também ajuda quem administra um conjunto de Skills e quer reduzir instalações impulsivas. A própria instrução exige comparar contagem de instalações, reputação da fonte e estrelas do repositório antes da recomendação. Esses sinais ajudam a priorizar, mas não provam segurança, qualidade ou adequação. Um projeto popular ainda pode pedir permissões excessivas, executar scripts ou estar desatualizado.
A finalidade é distinta das páginas já publicadas no Bastidores. Auditoria de Skill examina permissões e riscos de uma candidata conhecida. NVIDIA Skill Card Generator cria documentação de Skills. Find Skills atua antes das duas: transforma uma necessidade em opções pesquisáveis e entrega origem, adoção e comando para revisão humana.
Compatibilidade e pré-requisitos
O README oficial lista Codex com instalação por projeto em .agents/skills/ e instalação global em ~/.codex/skills/. A mesma tabela documenta dezenas de outros agentes. Compatibilidade aqui significa que o CLI conhece o diretório de destino. O agente ainda precisa carregar o SKILL.md e respeitar suas próprias regras de permissão.
Na versão 1.5.22, o pacote exige Node.js 22.20.0 ou mais recente e um npm capaz de executar pacotes com npx ou npm exec. A pesquisa requer rede para consultar skills.sh. A instalação também pode acessar GitHub, GitLab, uma URL direta ou outra origem aceita pelo CLI.
O download hospedado pelo Bastidores não inclui o Skills CLI. Ele contém somente o SKILL.md original, a licença MIT e o registro de origem. Portanto, é adequado para leitura e conferência, mas não substitui Node.js, npm nem a ferramenta oficial.
Instalação recomendada
Para instalar apenas a Find Skills no Codex, comece em um projeto de teste e mantenha a confirmação interativa:
npx skills add vercel-labs/skills --skill find-skills -a codex --copyO --copy cria uma cópia independente no destino em vez de depender de link simbólico. Não use -g ou -y na primeira tentativa. Assim, você vê o escopo e confirma a instalação antes da escrita. Depois, confira a pasta criada, leia o arquivo e registre o commit que aprovou.
O README do Skills CLI também documenta listagem, atualização e remoção. Não trate update como operação neutra: ele pode substituir o conteúdo de Skills instaladas. Revise mudanças e mantenha uma forma de voltar à versão anterior.
Configuração antes do primeiro uso
Defina primeiro onde a Skill ficará. Instalação por projeto reduz o alcance e permite revisar o arquivo junto do trabalho. Instalação global facilita o uso em vários projetos, mas amplia o impacto de uma alteração futura. Para a primeira avaliação, prefira o projeto descartável e uma cópia, não um vínculo compartilhado.
Depois decida sobre telemetria. O README declara telemetria anônima habilitada por padrão. No código auditado, uma busca registra a consulta e a quantidade de resultados em um endpoint separado. As variáveis DISABLE_TELEMETRY=1 e DO_NOT_TRACK=1 desativam telemetria e a consulta automática de auditoria.
Isso não transforma a busca em operação offline. O termo pesquisado continua sendo enviado à API de skills.sh porque ele é necessário para obter resultados. Não pesquise nomes de clientes, caminhos internos, incidentes sigilosos ou qualquer dado que não deveria sair do ambiente.
Primeiro uso seguro
Faça uma consulta genérica, específica e sem dados sensíveis:
DISABLE_TELEMETRY=1 npx skills find pdfNo teste editorial de 13/08/2026, executado com a versão 1.5.22 e telemetria desativada, a consulta retornou 20 itens. Os primeiros resultados foram anthropics/skills@pdf, com 178,2 mil instalações exibidas, e openai/skills@pdf, com 11,5 mil. Esses números são um retrato do teste, não um ranking permanente.
O resultado esperado é uma lista com owner/repo@skill, instalações e link para a página no catálogo skills.sh. Antes de instalar qualquer opção, abra o repositório, confirme licença, mantenedor, última versão, pasta correta, arquivos auxiliares, comandos, rede, escrita e credenciais. A Find Skills recomenda essa verificação, mas não a executa de forma completa por você.
Permissões e riscos
O arquivo da Find Skills é apenas Markdown. Mesmo assim, ele instrui o agente a executar comandos com rede e a oferecer instalação. Em terminal interativo, selecionar um resultado no modo sem consulta pode iniciar o fluxo add. Esse fluxo pode baixar repositórios e gravar arquivos no diretório do projeto ou no diretório global do agente.
O código da busca mostra o uso da API, o limite de 20 resultados e o evento de telemetria. O módulo de telemetria aponta para os endpoints de evento e auditoria. Desativar a telemetria reduz esse envio adicional, mas não elimina a rede usada para pesquisar ou baixar conteúdo.
O risco maior aparece depois da descoberta. Uma Skill instalada passa a orientar um agente que pode ter acesso amplo a arquivos, terminal, navegador ou serviços conectados. Nunca aceite uma recomendação só por instalações ou estrelas. Use a Auditoria de Skill do Bastidores para mapear efeitos antes de habilitar a candidata em um projeto real.
Erros comuns
skills não é reconhecido no Windows
No nosso teste, a execução direta pelo atalho do npx não expôs o binário, embora o pacote público declarasse corretamente skills em bin. A validação funcionou depois de instalar skills@1.5.22 em um diretório isolado e chamar o executável em node_modules/.bin. Confira a versão do Node e do npm, limpe apenas o ambiente de teste e prefira o comando recomendado pelo README atual.
A busca não mostra nada
Use pelo menos dois caracteres, tente sinônimos e remova termos internos. Verifique rede e disponibilidade de skills.sh. Em um agente ou terminal não interativo, chamar npx skills find sem consulta não abre o seletor, ele apenas mostra a sintaxe esperada.
O resultado parece popular, mas a origem é fraca
Abra a página e o repositório. Confirme se o caminho apontado contém o SKILL.md, se a licença cobre aquela pasta e se scripts ou referências fazem parte do pacote. Instalações e estrelas são sinais de adoção, não aprovação de segurança.
A Skill foi instalada no lugar errado
Revise as opções de agente, escopo global ou por projeto e modo cópia ou link. Remova somente a pasta criada pelo teste depois de confirmar o caminho exato. Não apague diretórios compartilhados para corrigir uma instalação mal direcionada.
Versão auditada e download local
- Repositório:
vercel-labs/skills. - Caminho:
skills/find-skills. - Skills CLI:
1.5.22. - Commit:
c6f69c631292444cc541ac6d91e2226b0ff247da. - Estrelas: 28.808 em 13/08/2026, consultadas na API pública do GitHub.
- Licença: MIT.
- Conteúdo do ZIP: find-skills/SKILL.md, LICENSE e ORIGEM.md.
- SHA-256 do SKILL.md:
c1d9628984991d7ed59ab3a7bf6a4dad3d731ef68c71f409f64a0ca258e8028e. - SHA-256 do ZIP:
e668cefa1f9cf3d45fef9bd3c63fc912919f4ac8490a49945e4032ed8b6c557d.
O download local serve para conferir a instrução exata que foi curada. O botão separado do repositório oficial deve ser usado para acompanhar mudanças, consultar o código do CLI e instalar a versão atual quando você decidir avançar. A licença MIT preservada no ZIP permite redistribuição com manutenção do aviso.
Resultado esperado e limite final
Uma boa execução termina com uma lista curta de candidatas, cada uma com finalidade, origem, adoção observada, comando e link para auditoria. A instalação acontece somente depois de escolher a opção e entender onde ela gravará arquivos.
O limite final é simples: Find Skills melhora a descoberta, não certifica o resultado. Catálogo, ranking e telemetria mudam. A revisão humana do repositório, da licença, dos arquivos e das permissões continua obrigatória antes de confiar uma nova instrução ao agente.
Fontes primárias
CONFIGURAÇÃO
Instale só depois de ler.
Abra a fonte oficial, leia README e licença, fixe uma versão ou commit e só então siga o método indicado pelo mantenedor. Não execute comandos copiados de comentários ou vídeos sem revisão.
Skills CLI para Codex
npx skills add vercel-labs/skills --skill find-skills -a codex --copyInstale primeiro por projeto, mantenha a confirmação interativa e revise a pasta criada. A busca consulta skills.sh e a telemetria do CLI vem habilitada por padrão; use DISABLE_TELEMETRY=1 ou DO_NOT_TRACK=1 quando necessário.
Abra a fonte e o README
- Confira mantenedor e nome do repositório.
- Leia licença, requisitos e permissões.
- Escolha uma versão ou commit para aprovar.
Comece em um projeto de teste
- Use o comando acima ou o método do README.
- Prefira instalação por projeto antes da global.
- Não copie tokens, chaves ou arquivos sensíveis.
Faça um teste pequeno
- Confirme a descrição e os arquivos instalados.
- Execute uma tarefa reversível.
- Registre versão aprovada e remova o que não usar.