Skill Scout
Use esta habilidade antes de criar uma nova habilidade. O objetivo é evitar duplicar trabalho existente da comunidade ou do marketplace, ao mesmo tempo que avalia qualquer conteúdo externo antes da adoção.
Fonte: recuperado do PR #1232 da comunidade 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 faz Y?"
- O usuário descreve um fluxo de trabalho e você está prestes a sugerir a criação de uma nova habilidade.
- O usuário quer bifurcar (fork) ou estender uma habilidade existente.
Se o usuário disser explicitamente para pular a pesquisa ou criar do zero, reconheça isso e prossiga com o fluxo de criação solicitado.
Como Funciona
Passo 1 - Capturar Intenção
Extraia:
- A tarefa que a habilidade deve realizar.
- 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.
Passo 2 - Pesquisar Fontes Locais
Pesquise primeiro os nomes das habilidades instaladas e do marketplace. Fontes locais são preferíveis 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 descrições no frontmatter:
grep -RilE "palavra-chave|sinônimo" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null
Passo 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
Passo 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 de shell inesperados, escrita 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 branch local novo e revisar o diff em vez de editar originais do marketplace.
Passo 5 - Classificar Resultados
Classifique os candidatos por:
- Correspondência exata de palavra-chave no nome da habilidade.
- Correspondência de palavra-chave ou sinônimo na descrição.
- Fonte instalada local ou do marketplace.
- Fonte GitHub mantida com atividade recente.
- Menção apenas na web.
Limite a lista final em 10 resultados.
Passo 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. |
Apenas crie uma nova habilidade depois que o usuário escolher esse caminho ou depois que a pesquisa não encontrar nenhuma correspondência próxima.
Exemplos
Tabela de Resultados
| # | Habilidade | Fonte | Por que corresponde | Lacuna |
| --- | --- | --- | --- | --- |
| 1 | article-writing | ECC Local | Redige artigos e guias | Não focado em notas de versão |
| 2 | content-engine | ECC Local | Fluxo de conteúdo multi-formato | Mais pesado que o 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 opção 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 nota de versão ou
criar uma nova habilidade.
Anti-Padrões
- Não pule diretamente para a criação de 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 apenas na web como fontes confiáveis.
- Não edite originais do marketplace instalados diretamente.
Relacionados
search-first- Fluxo geral de pesquisa antes de construir.skill-stocktake- Auditar habilidades instaladas quanto a saúde, duplicatas e lacunas.agent-sort- Categorizar e organizar agentes e habilidades existentes.