Skill Scout

Use esta habilidade antes de criar uma nova. O objetivo é evitar duplicar trabalhos existentes da comunidade ou do marketplace, ao mesmo tempo em que se verifica qualquer coisa externa antes da adoção.

Fonte: recuperado de PR #1232 da comunidade, inativo, 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 fazer um fork ou estender uma habilidade existente.

Se o usuário explicitamente pedir para pular a busca ou criar do zero, reconheça isso e prossiga com o fluxo de trabalho de criação solicitado.

Como Funciona

Etapa 1 - Capturar Intenção

Extrair:

• 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 busca mais sinônimos úteis.

Etapa 2 - Buscar Fontes Locais

Busque primeiro 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 "keyword|synonym"
find ~/.claude/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "keyword|synonym"

Em seguida, busque descrições no frontmatter:

grep -RilE "keyword|synonym" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null

Etapa 3 - Buscar Fontes Remotas

Use ferramentas de busca do GitHub e da web disponíveis. Prefira consultas concisas:

gh search repos "claude code skill keyword" --limit 10 --sort stars
gh search code "name: keyword" --filename SKILL.md --limit 10

Para busca na web, use no máximo três consultas direcionadas, como:

"claude code skill" keyword
"SKILL.md" keyword
"affaan-m/ECC" keyword

Etapa 4 - Avaliar Correspondências Externas

Antes de recomendar qualquer habilidade externa para adoção ou fork:

• Leia o frontmatter e as instruções de SKILL.md.
• Procure por comandos de shell inesperados, gravações de arquivos, chamadas de rede, manipulação de credenciais ou instalações de pacotes.
• Verifique se o repositório parece ser mantido.
• Prefira copiar para um novo branch local e revisar as diferenças em vez de editar originais do marketplace.

Etapa 5 - Classificar Resultados

Classifique os candidatos por:

1. Correspondência exata da palavra-chave no nome da habilidade.
2. Correspondência de palavra-chave ou sinônimo na descrição.
3. Fonte local instalada ou do marketplace.
4. Fonte mantida no GitHub com atividade recente.
5. Menção apenas na web.

Limite a lista final a 10 resultados.

Etapa 6 - Apresentar Opções de Decisão

Dê ao usuário uma tabela curta:

Crie uma nova habilidade apenas após o usuário escolher esse caminho ou após a busca não encontrar uma correspondência próxima.

Exemplos

Tabela de Resultados

| # | Skill | Source | Why it matches | Gap |
| --- | --- | --- | --- | --- |
| 1 | article-writing | Local ECC | Drafts articles and guides | Not focused on release notes |
| 2 | content-engine | Local ECC | Multi-format content workflow | Heavier than needed |
| 3 | blog-writer | GitHub | Blog writing skill with recent commits | Needs security review |

Resumo para o Usuário

I found two close local matches and one external candidate. The closest fit is
`article-writing`; it covers drafting and revision, but it does not include the
release-note checklist you asked for. I can either use it as-is, fork it into a
release-note variant, or create a fresh skill.

Anti-Padrões

• Não pule diretamente para a criação de uma nova habilidade quando uma busca for 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 no local.

Relacionados

• search-first - Fluxo de trabalho geral de busca antes de construir.
• skill-stocktake - Auditar habilidades instaladas quanto à saúde, duplicatas e lacunas.
• agent-sort - Categorizar e organizar agentes e habilidades existentes.