Skill Finder (Find ClawHub skills + Search Skills.sh)

• Você quer que seu agente sugira proativamente skills instaláveis sempre que um usuário descrever funcionalidades ausentes ou perguntar como automatizar uma tarefa.
• Você precisa comparar opções tanto no registro curado do ClawHub quanto no ecossistema aberto mais amplo do Skills.sh antes de confirmar uma instalação.
• Você quer um fluxo de descoberta consistente e ciente de preferências — a skill lembra das skills curtidas/ignoradas e da sua fonte de busca preferida entre sessões.
• Um usuário pergunta "o que devo instalar para X?" e você quer uma resposta estruturada e avaliada em vez de um despejo bruto de resultados de busca.

• Você só precisa pesquisar em um único registro já conhecido e não tem interesse em comparação entre ecossistemas.
• Seu ambiente não consegue executar comandos npx (necessários para as CLIs clawhub e skills).

Pesquisa tanto no registro curado do ClawHub (npx clawhub search) quanto no ecossistema aberto do Skills.sh (npx skills find) por padrão. Os resultados de ambas as fontes são comparados lado a lado para que você sempre veja a opção mais forte entre os ecossistemas, não apenas a primeira correspondência encontrada.

Ativa em sinais como "como faço X?" ou "isso pode ser automatizado?" — não apenas em solicitações explícitas de "encontrar uma skill". Isso fecha a lacuna entre um usuário descrevendo uma necessidade e a descoberta de que uma skill instalável já resolve o problema.

Cada candidato é avaliado com base na clareza da descrição, número de downloads, recência da última atualização e reputação do autor antes de ser recomendado. Os resultados são classificados com um vencedor claro e notas explícitas sobre as vantagens e desvantagens — nunca uma simples lista bruta.

Armazena seu modo de fonte preferido (both, clawhub ou skills.sh), skills curtidas, skills descartadas e preferências declaradas em ~/skill-finder/memory.md. Buscas futuras respeitam essas configurações automaticamente.

Nunca realiza instalações automáticas. Cada recomendação exige consentimento explícito do usuário, ignora flags de instalação forçada, evita alterações silenciosas no escopo global e exibe avisos do scanner antes de prosseguir.

Traduz solicitações vagas dos usuários em termos de busca precisos — por exemplo, "ajuda com PDFs" se transforma em consultas direcionadas separadas para edição, geração ou análise — reduzindo ruídos e melhorando a relevância dos resultados.

Um usuário diz "Preciso extrair texto de PDFs." O Skill Finder (Find ClawHub skills + Search Skills.sh) detecta a lacuna de capacidade, pesquisa nos dois ecossistemas por pdf parse e pdf extract, avalia os principais candidatos e apresenta uma recomendação classificada com o comando de instalação exato — sem que o usuário precise digitar "encontre uma skill".

Um usuário está frustrado com uma ferramenta lenta ou sem manutenção que já possui instalada. O Skill Finder (Find ClawHub skills + Search Skills.sh) busca alternativas, filtra resultados com poucos downloads ou desatualizados, e recomenda um substituto mais bem mantido com uma comparação lado a lado dos prós e contras.

Uma equipe quer padronizar o uso do Skills.sh em um workspace específico. O usuário define o modo de origem como skills.sh, e o Skill Finder (Find ClawHub skills + Search Skills.sh) salva essa preferência — todas as pesquisas futuras nesse workspace consultam apenas o ecossistema do Skills.sh até que a configuração seja alterada.

Um desenvolvedor iniciando um novo projeto pergunta "o que devo instalar para testes em React?" O Skill Finder traduz isso em consultas de busca específicas, compara os resultados do ClawHub e do Skills.sh, e apresenta as 1 a 3 melhores opções com comandos de instalação e justificativas.