O que Agent Doctor faz?
Use esta skill para fundamentar o diagnóstico de instruções de agente e descoberta de skills nos arquivos realmente presentes. Ela relata fontes como descobertas, nunca como carregadas em tempo de execução ou configuradas como disponíveis.
Execute a varredura determinística primeiro, depois raciocine apenas a partir do relatório e dos arquivos que ele nomeia. A varredura é somente leitura e nunca corrige arquivos, carrega skills, solicita permissões ou lê arquivos gerais de home, ambiente, credenciais ou autenticação.
A partir do diretório instalado desta skill, execute:
python3 scripts/agent_doctor.py --project <caminho-para-o-projeto> --format markdown
Use --home /fixture/home para fixture ou descoberta global alternativa. Adicione um --skill-root /caminho/para/skills explícito apenas para raízes de skills adicionais permitidas. --model <nome> recebe o modelo que você está executando (qualquer nome literal, como Claude, claude-opus-5-5 ou GPT-5), compara-o com declarações literais de identidade "Você é " em prosa normal de skills, ignorando maiúsculas/minúsculas, hífens vs espaços ou pontos, e um prefixo claude-, e relata incompatibilidades apenas como avisos. Omita-o para pular essa verificação. Selecione --format json para saída legível por máquina. Use --max-files, --max-bytes e --max-directories para restringir a varredura limitada para um diagnóstico focado.
A varredura limita profundidade, diretórios, arquivos e bytes; ela ignora diretórios de dependências, VCS, cache e worktree. Ela reconhece arquivos AGENTS.md/ CLAUDE.md/GEMINI.md ancestrais e aninhados, os arquivos de instrução global na lista de permissões (~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, ~/.gemini/GEMINI.md), e pastas de skills planas em cada pasta do host documentada: home .agents, .codex, .claude, .gemini, .cursor, .copilot e .codeium/windsurf skills, e projeto .agents, .codex, .claude, .gemini, .cursor, .github, .opencode, .cline, .clinerules, .devin e .windsurf skills. Uma skill alcançada por várias pastas (por exemplo, os links simbólicos do Skills CLI) é relatada uma vez. Ela mantém caminhos canônicos e aliases separados, rejeita escapes de link simbólico e não emite conteúdo bruto de arquivo.
Uso e arquivamento de skills
Para skills raramente ou nunca chamadas, execute python3 scripts/agent_doctor.py --usage e siga references/usage.md. Ele lê logs de sessão como somente leitura e imprime apenas nomes de skills e contagens. Mostre ao proprietário a tabela, depois pergunte por skill: atualizar, manter ou arquivar. Diga "nenhuma chamada encontrada nos logs", nunca "não utilizada". Arquive apenas com scripts/skill_archive.py: plan, mostre-o, obtenha um sim explícito para aquela skill, depois archive --yes; nunca na mesma vez que a pergunta. Mencione restore.