Que fait Agent Doctor ?
Utilisez cette compétence pour fonder le diagnostic des instructions agent et de la découverte de compétences sur les fichiers réellement présents. Elle signale les sources comme découvertes, jamais comme chargées à l'exécution ou configurées disponibles.
Exécutez d'abord le scan déterministe, puis raisonnez uniquement à partir du rapport et des fichiers qu'il nomme. Le scan est en lecture seule et ne répare jamais les fichiers, ne charge pas les compétences, ne demande pas d'autorisations, ni ne lit les fichiers généraux de home, d'environnement, d'identifiants ou d'authentification.
Depuis le répertoire installé de cette compétence, exécutez :
python3 scripts/agent_doctor.py --project <chemin-vers-projet> --format markdown
Utilisez --home /fixture/home pour une découverte de fixture ou globale alternative. Ajoutez un --skill-root /chemin/vers/competences explicite uniquement pour des racines de compétences supplémentaires autorisées. --model <nom> prend le modèle que vous exécutez (n'importe quel nom littéral, tel que Claude, claude-opus-5-5 ou GPT-5), le compare aux affirmations d'identité littérales « Vous êtes <modèle> » dans le prose normal des compétences, en ignorant la casse, les traits d'union par rapport aux espaces ou aux points, et un préfixe claude-, et signale les discordances comme des avis uniquement. Omettez-le pour ignorer cette vérification. Sélectionnez --format json pour une sortie lisible par machine. Utilisez --max-files, --max-bytes et --max-directories pour resserrer le scan délimité pour un diagnostic ciblé.
Le scan délimite la profondeur, les répertoires, les fichiers et les octets ; il ignore les répertoires de dépendances, VCS, de cache et de worktree. Il reconnaît les fichiers AGENTS.md/ CLAUDE.md/GEMINI.md ancêtres et imbriqués, les fichiers d'instructions globaux autorisés (~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, ~/.gemini/GEMINI.md) et les dossiers de compétences plats dans chaque dossier hôte documenté : home .agents, .codex, .claude, .gemini, .cursor, .copilot et .codeium/windsurf compétences, et projet .agents, .codex, .claude, .gemini, .cursor, .github, .opencode, .cline, .clinerules, .devin et .windsurf compétences. Une compétence atteinte via plusieurs dossiers (par exemple les liens symboliques du CLI Skills) est signalée une fois. Elle maintient les chemins canoniques et les alias séparés, rejette les échappements de liens symboliques et n'émet aucun contenu de fichier brut.
Utilisation et archivage des compétences
Pour les compétences rarement ou jamais appelées, exécutez python3 scripts/agent_doctor.py --usage et suivez references/usage.md. Il lit les journaux de session en lecture seule et imprime uniquement les noms de compétences et les compteurs. Montrez le tableau au propriétaire, puis demandez par compétence : mettre à jour, conserver ou archiver. Dites « aucun appel trouvé dans les journaux », jamais « inutilisé ». Archivez uniquement avec scripts/skill_archive.py : plan, montrez-le, obtenez un oui explicite pour cette compétence, puis archive --yes ; jamais dans le même tour que la question. Mentionnez restore.