wiki-agents-md — Générateur de fichiers AGENTS.md
Ce skill fait partie du repository microsoft/skills, une collection de skills, serveurs MCP, agents personnalisés et fichiers AGENTS.md destinés à ancrer les coding agents dans leur contexte de projet. Il s'intègre au plugin deep-wiki (.github/plugins/deep-wiki/) et a pour mission de générer automatiquement des fichiers AGENTS.md dans les dossiers pertinents d'un repository.
Rôle et fonctionnement
Contrairement à un simple squelette, ce skill contient des instructions détaillées et opérationnelles. Il définit précisément quels dossiers doivent recevoir un AGENTS.md (racine du repo, dossiers src/, tests/, packages monorepo, wiki VitePress généré par deep-wiki, etc.), lesquels doivent être ignorés (dépendances tierces, artefacts de build), et comment composer chaque fichier en six zones thématiques : commandes de build, instructions de test, structure du projet, conventions de style, workflow Git et limites opérationnelles.
La règle la plus critique encodée dans ce skill est la protection contre l'écrasement : avant toute génération, il vérifie si un AGENTS.md existe déjà dans le dossier cible. Si c'est le cas, il passe au suivant sans modifier l'existant. Cette logique s'applique indépendamment à chaque dossier.
AGENTS.md vs README.md
Le skill formalise une distinction conceptuelle importante : le README.md s'adresse aux humains, tandis que l'AGENTS.md s'adresse aux coding agents. Ce dernier contient des commandes exactes avec leurs flags, des chemins de fichiers réels, des exemples de code tirés du projet lui-même, et des directives comportementales claires (toujours faire / demander d'abord / ne jamais faire). Le skill prévoit également la génération d'un CLAUDE.md compagnon dans chaque dossier traité, redirectionnant Claude Code vers l'AGENTS.md correspondant.
Utilisation dans deep-wiki
Ce skill est conçu pour être invoqué dans le cadre du workflow deep-wiki de Microsoft. Il s'applique notamment au dossier wiki/ généré par VitePress et fournit un template spécifique pour ce contexte (commandes npm run dev / build / preview, conventions Mermaid en dark mode, structure des fichiers de documentation). Les fichiers produits sont intentionnellement concis — 30 à 80 lignes — et ne contiennent que des informations vérifiables dans le code source réel du repository cible.