¿Qué hace Agent Doctor?
Usa esta habilidad para fundamentar el diagnóstico de las instrucciones del agente y el descubrimiento de habilidades en los archivos realmente presentes. Reporta las fuentes como descubiertas, nunca como cargadas en tiempo de ejecución o configuradas como disponibles.
Ejecuta primero el escaneo determinista y luego razona únicamente a partir del informe y los archivos que nombra. El escaneo es de solo lectura y nunca corrige archivos, carga habilidades, solicita permisos ni lee archivos generales del hogar, entorno, credenciales o autenticación.
Desde el directorio instalado de esta habilidad, ejecuta:
python3 scripts/agent_doctor.py --project <ruta-al-proyecto> --format markdown
Usa --home /fixture/home para entornos de prueba o descubrimiento global alternativo. Añade un --skill-root /ruta/a/habilidades explícito solo para raíces de habilidades adicionales permitidas. --model <nombre> toma el modelo que estás ejecutando (cualquier nombre literal, como Claude, claude-opus-5-5 o GPT-5), lo compara con las afirmaciones literales «You are » en el texto normal de las habilidades, ignorando mayúsculas/minúsculas, guiones frente a espacios o puntos, y un prefijo claude-, e informa las discrepancias solo como advertencias. Omítelo para saltar esa comprobación. Selecciona --format json para una salida legible por máquina. Usa --max-files, --max-bytes y --max-directories para ajustar el escaneo acotado a un diagnóstico enfocado.
El escaneo limita la profundidad, los directorios, los archivos y los bytes; salta los directorios de dependencias, VCS, caché y worktree. Reconoce los archivos AGENTS.md/CLAUDE.md/GEMINI.md antecesores y anidados, los archivos de instrucciones globales permitidos (~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, ~/.gemini/GEMINI.md) y las carpetas planas de habilidades en cada carpeta anfitriona documentada: habilidades del hogar .agents, .codex, .claude, .gemini, .cursor, .copilot y .codeium/windsurf, y habilidades del proyecto .agents, .codex, .claude, .gemini, .cursor, .github, .opencode, .cline, .clinerules, .devin y .windsurf. Una habilidad alcanzada a través de varias carpetas (por ejemplo, los enlaces simbólicos de la CLI de Skills) se reporta una sola vez. Mantiene separadas las rutas canónicas y los alias, rechaza los escapes de enlaces simbólicos y no emite contenido de archivo sin procesar.
Uso y archivado de habilidades
Para habilidades rara vez o nunca invocadas, ejecuta python3 scripts/agent_doctor.py --usage y sigue references/usage.md. Lee los registros de sesión en modo solo lectura e imprime solo los nombres de las habilidades y sus recuentos. Muestra al propietario la tabla y luego pregunta por cada habilidad: actualizar, conservar o archivar. Di «no se encontraron llamadas en los registros», nunca «sin usar». Archiva solo con scripts/skill_archive.py: plan, muéstralo, obtén un sí explícito para esa habilidad, luego archive --yes; nunca en el mismo turno que la pregunta. Menciona restore.