skill-stocktake

Comando de barra (/skill-stocktake) que audita todas as skills e comandos do Claude usando uma lista de verificação de qualidade + julgamento holístico de IA. Suporta dois modos: Varredura Rápida para skills alteradas recentemente e Inventário Completo para uma revisão completa.

Escopo

O comando tem como alvo os seguintes caminhos relativos ao diretório onde é invocado:

No início da Fase 1, o comando lista explicitamente quais caminhos foram encontrados e escaneados.

Diretórios chamados .trash são excluídos de ambos os modos de varredura: skills arquivadas não fazem parte do inventário ativo. Se um results.json mais antigo contiver entradas .trash, inicie um novo Inventário Completo usando a inicialização do cache abaixo antes de retomar a Varredura Rápida. Um salvamento comum mescla entradas e não remove registros arquivados.

Direcionando um projeto específico

Para incluir skills em nível de projeto, execute a partir do diretório raiz desse projeto:

cd ~/path/to/my-project
/skill-stocktake

Se o projeto não tiver um diretório .claude/skills/, apenas skills e comandos globais serão avaliados.

Modos

Os scripts shell exigem Bash, Node.js e jq em PATH.

Cache de resultados: ~/.claude/skills/skill-stocktake/results.json

Fluxo da Varredura Rápida

Reavalie apenas as skills que mudaram desde a última execução (5–10 min).

1. Leia ~/.claude/skills/skill-stocktake/results.json
2. Execute: bash ~/.claude/skills/skill-stocktake/scripts/quick-diff.sh \ ~/.claude/skills/skill-stocktake/results.json (O diretório do projeto é detectado automaticamente de $PWD/.claude/skills; passe-o explicitamente apenas se necessário)
3. Se a saída for []: reporte "Nenhuma alteração desde a última execução." e pare
4. Reavalie apenas os arquivos alterados usando os mesmos critérios da Fase 2
5. Mantenha as skills inalteradas dos resultados anteriores
6. Saída apenas da diferença
7. Execute: bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \ ~/.claude/skills/skill-stocktake/results.json <<< "$EVAL_RESULTS"

Fluxo do Inventário Completo

Fase 1 — Inventário

Execute todo este bloco em uma única invocação Bash. Ele imprime o inventário para o agente e inicializa uma nova execução completa apenas quando não há uma execução inacabada para retomar:

(
  set -euo pipefail
  SCAN_JSON=$(bash ~/.claude/skills/skill-stocktake/scripts/scan.sh)
  printf '%s\n' "$SCAN_JSON"
  RESULTS_JSON=~/.claude/skills/skill-stocktake/results.json

  CACHE_STATUS=""
  if [[ -f "$RESULTS_JSON" ]]; then
    CACHE_STATUS=$(jq -r '.batch_progress.status // ""' "$RESULTS_JSON")
  fi
  if [[ "$CACHE_STATUS" == "in_progress" ]]; then
    RESUMED_RESULTS=$(jq --slurpfile saved "$RESULTS_JSON" '
      . as $inventory | $saved[0]
      | .skills = (.skills | to_entries
        | map(.key = (.value.path // .key))
        | map(select(. as $entry
          | $entry.value.mtime != null
            and any($inventory.skills[];
              .path == $entry.key and .mtime == $entry.value.mtime)))
        | from_entries)
      | .mode = "full"
      | .batch_progress = {
          total: ($inventory.skills | length),
          evaluated: (.skills | length), status: "in_progress"
        }
    ' <<< "$SCAN_JSON")
    bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \
      "$RESULTS_JSON" --replace <<< "$RESUMED_RESULTS"
  else
    INITIAL_RESULTS=$(printf '%s\n' "$SCAN_JSON" | jq '{
      mode: "full", skills: {},
      batch_progress: {total: (.skills | length), evaluated: 0, status: "in_progress"}
    }')
    bash ~/.claude/skills/skill-stocktake/scripts/save-results.sh \
      "$RESULTS_JSON" --replace <<< "$INITIAL_RESULTS"
  fi
)

O script enumera os arquivos de skill, extrai o frontmatter e coleta os mtimes UTC. O diretório do projeto é detectado automaticamente de $PWD/.claude/skills; passe-o explicitamente apenas se necessário. Apresente o resumo da varredura e a tabela de inventário da saída do script:

Scanning:
  ✓ ~/.claude/skills/         (17 files)
  ✗ {cwd}/.claude/skills/    (not found — global skills only)

…