Skill Scout
Use esta habilidade antes de criar uma nova habilidade. O objetivo é evitar duplicar trabalho existente da comunidade ou marketplace, enquanto ainda avalia qualquer conteúdo externo antes da adoção.
Fonte: recuperado do stale community PR #1232 por redminwang.
Quando Usar
- O usuário diz "criar uma habilidade", "construir uma habilidade", "fazer uma habilidade" ou "nova habilidade".
- O usuário pergunta "existe uma habilidade para X?" ou "existe uma habilidade que faça Y?"
- O usuário descreve um fluxo de trabalho e você está prestes a sugerir criar uma nova habilidade.
- O usuário quer bifurcar ou estender uma habilidade existente.
Se o usuário explicitamente disser para pular a pesquisa ou criar do zero, reconheça isso e prossiga com o fluxo de criação solicitado.
Como Funciona
Etapa 1 - Capturar Intenção
Extraia:
- A tarefa que a habilidade deve executar.
- As condições de gatilho para usá-la.
- O domínio, ferramentas, frameworks ou fontes de dados envolvidos.
- Três a cinco palavras-chave de pesquisa mais sinônimos úteis.
Etapa 2 - Pesquisar Fontes Locais
Pesquise primeiro os nomes de habilidades instaladas e do marketplace. Fontes locais são preferidas porque já fazem parte do ambiente do usuário.
find ~/.claude/skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -iE "palavra-chave|sinônimo"
find ~/.claude/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "palavra-chave|sinônimo"
Depois pesquise nas descrições do frontmatter:
grep -RilE "palavra-chave|sinônimo" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null
Etapa 3 - Pesquisar Fontes Remotas
Use ferramentas disponíveis de pesquisa no GitHub e web. Prefira consultas concisas:
gh search repos "claude code skill palavra-chave" --limit 10 --sort stars
gh search code "name: palavra-chave" --filename SKILL.md --limit 10
Para pesquisa web, use no máximo três consultas direcionadas como:
"claude code skill" palavra-chave
"SKILL.md" palavra-chave
"everything-claude-code" palavra-chave
Etapa 4 - Avaliar Correspondências Externas
Antes de recomendar qualquer habilidade externa para adoção ou bifurcação:
- Leia o frontmatter e as instruções do
SKILL.md. - Procure por comandos shell inesperados, gravações de arquivos, chamadas de rede, manipulação de credenciais ou instalações de pacotes.
- Verifique se o repositório parece mantido.
- Prefira copiar para um novo branch local e revisar o diff em vez de editar originais do marketplace.
Etapa 5 - Classificar Resultados
Classifique candidatos por:
- Correspondência exata de palavra-chave no nome da habilidade.
- Correspondência de palavra-chave ou sinônimo na descrição.
- Fonte local instalada ou do marketplace.
- Fonte GitHub mantida com atividade recente.
- Menção web apenas.
Limite a lista final a 10 resultados.
Etapa 6 - Apresentar Opções de Decisão
Dê ao usuário uma tabela resumida:
| Opção | Significado |
|---|---|
| Usar existente | Invocar ou instalar uma habilidade correspondente como está. |
| Bifurcar ou estender | Copiar a habilidade mais próxima e modificá-la. |
| Criar do zero | Construir uma nova habilidade após confirmar que não existe correspondência próxima. |
Só crie uma nova habilidade depois que o usuário escolher esse caminho ou após a pesquisa não encontrar correspondência próxima.
Exemplos
Tabela de Resultados
| # | Habilidade | Fonte | Por que corresponde | Lacuna |
| --- | --- | --- | --- | --- |
| 1 | article-writing | Local ECC | Redige artigos e guias | Não focado em notas de versão |
| 2 | content-engine | Local ECC | Fluxo de trabalho de conteúdo multi-formato | Mais pesado do que necessário |
| 3 | blog-writer | GitHub | Habilidade de escrita de blog com commits recentes | Precisa de revisão de segurança |
Resumo para o Usuário
Encontrei duas correspondências locais próximas e um candidato externo. A correspondência mais
próxima é `article-writing`; ela cobre redação e revisão, mas não inclui a lista de
verificação de notas de versão que você pediu. Posso usá-la como está, bifurcá-la em uma
variante de notas de versão ou criar uma nova habilidade.
Anti-Padrões
- Não pule diretamente para a criação de uma nova habilidade quando uma pesquisa é razoável.
- Não instale habilidades externas sem lê-las primeiro.
- Não apresente uma longa lista não classificada de correspondências fracas.
- Não trate menções web apenas como fontes confiáveis.
- Não edite originais do marketplace instalados no local.
Relacionados
search-first- Fluxo de trabalho geral de pesquisar antes de construir.skill-stocktake- Auditar habilidades instaladas quanto a integridade, duplicatas e lacunas.agent-sort- Categorizar e organizar agentes e habilidades existentes.