/skill-prospector — prospecta o workspace e sugere skills que cabem ali

O skill-scout parte de uma ideia que voce ja tem. Esta skill parte de um workspace sem ideia previa: ela gera as ideias lendo o repo. Pipeline do ateliE: prospectar (aqui) → buscar/forjar (/skill-scout) → instalar (/install-skill).

Regra de ouro: recomende primeiro o que ja existe na biblioteca do usuario (instalar via /install-skill); so proponha forjar algo novo quando nada cobrir a necessidade.

Parametros

• [caminho] — workspace alvo. Default: diretorio atual.

Fluxo

1. Varrer (um comando — script determinístico)

O motor bundled faz toda a parte repetitiva (stack, scripts, configs, .claude/ existente, inventario do ateliE+global, camada ICM, README) e devolve JSON:

pwsh -NoProfile -File "<dir-da-skill>/scripts/scan-workspace.ps1" -Path "<caminho|.>"

Campos do JSON: detectedStack (languages/frameworks/databases/manifests/extHistogram) · taskSignals (packageScripts/makeTargets/ci/containers) · existingClaude (skills/commands/agents JA no alvo) · library.atelier + library.global (nome+descricao do que da pra instalar) · icm (CLAUDE.md/CONTEXT.md/.tasks/handoffs) · docs.readme · notes[].

Se notes[] apontar ateliE ausente, siga so com library.global — nao invente skills.

2. Mapear sinais → oportunidades (julgamento — seu)

Para cada sinal forte do scan, pergunte "isto seria melhor servido por uma skill?". Use o rubric abaixo. Exemplos de traducao sinal→oportunidade:

3. Deduplicar e casar com a biblioteca

• Ja instalado no alvo (existingClaude.skills) → nao sugira de novo. Mencione como "ja coberto".
• Existe na biblioteca (library.atelier/library.global) e cobre a necessidade → balde INSTALAR, acao /install-skill <nome>. Leia a description para confirmar aderencia real (nao recomende so pelo nome).
• Nada cobre → balde FORJAR, acao /skill-scout "<ideia em 1 frase>".

4. Aplicar o rubric "isto merece ser skill?"

Conta como candidata forte (≥1 dos sinais de criar, 0 dos de descartar):

Criar — workflow multi-passo reutilizavel · metodologia que se repete ("sempre faco assim") · tipo de tarefa recorrente com estrutura clara · processo de dominio com inputs/fases/outputs. Descartar — caso unico/nao recorrente · ja coberto por skill existente · julgamento puro sem parte deterministica/repetitiva · setup de uma vez so.

5. Ranquear e escrever o dossie (3 baldes)

Ordene por fit × valor. Para cada candidata, o suggestion shape:

### <nome-sugerido>   [confianca: alta|media|baixa]
- O que faria: <1-2 frases>
- Por que cabe AQUI: <ancorado no repo> — evidencia: <file:line | sinal do scan>
- Gatilhos: "<3-5 frases reais>"
- Acao: INSTALAR `/install-skill <nome>`  |  FORJAR `/skill-scout "<ideia>"`  |  PULAR (<motivo>)

Baldes: ① Ja na sua biblioteca → instalar · ② Vale forjar → novas · ③ Talvez depois (fit/valor baixo, 1 linha com o porque — sem ruido). Comece por um resumo de 2-3 linhas do que o repo e (stack + natureza) para o usuario confirmar que a leitura bateu.

6. Oferecer disparar (gate humano)

Apresente o dossie e use AskUserQuestion para o usuario escolher quais candidatas seguir. Para as escolhidas, dispare a acao: Skill: install-skill (com o nome) ou Skill: skill-scout (com a ideia como argumento). Nunca aja sem o aceite. Uma candidata = uma acao.

Exemplos de traducao

Guardrails

• Read-only no alvo. A skill so le o workspace; quem escreve sao /install-skill e /skill-scout, e so apos aceite. O unico efeito colateral e o dossie (texto).
• Anti-alucinacao. Nao afirme que uma skill da biblioteca "faz X" sem ter lido a description dela no JSON. Nao sugira candidata sem evidencia do scan. Sem ateliE/biblioteca → use so o que veio.
• Dedup de verdade. Cheque existingClaude antes de propor qualquer coisa.
• Camada ICM e bonus, nao requisito. Se icm.isICM for falso, ignore .tasks/handoffs e trate como repo generico. Silos do seu ecossistema: nao vaze contexto de um projeto vizinho para o dossie.
• Proporcional. Repo pequeno → poucas candidatas certeiras. Nao force 10 sugestoes.