wiki-ado-convert
Ce skill appartient au repository microsoft/skills, qui regroupe des skills, serveurs MCP, agents personnalisés et fichiers Agents.md destinés à outiller des coding agents. Contrairement à un simple squelette ou placeholder, wiki-ado-convert est un skill pleinement rédigé : il contient des instructions détaillées permettant à Claude de générer un script Node.js de conversion de documentation.
Ce que fait ce skill
Lorsqu'il est invoqué, ce skill demande à Claude de produire un script scripts/build-ado-wiki.js (module ESM, sans dépendances externes) qui transforme des fichiers Markdown écrits pour VitePress ou GFM en fichiers compatibles avec Azure DevOps Wiki. Les fichiers sources ne sont jamais modifiés : le script génère des copies transformées dans dist/ado-wiki/. Les transformations couvertes incluent la conversion des blocs Mermaid (syntaxe de fences et mots-clés), la suppression du front matter YAML, la réécriture des liens relatifs parents, et la conversion des directives de conteneurs VitePress en alertes blockquote ADO.
Structure des instructions
Le SKILL.md détaille chaque étape attendue de Claude : résolution du contexte git avant de commencer, tableau des incompatibilités critiques entre GFM et ADO Wiki, fonctions JavaScript commentées à inclure dans le script, gestion des fichiers .order pour le tri de la barre latérale, et génération d'une page index.md de qualité (sans placeholder). Une checklist de vérification post-exécution est également fournie.
Comment l'utiliser
Il suffit d'activer ce skill dans un agent ou une session Claude compatible avec le système de skills du repository microsoft/skills, puis de lui demander de générer le script de conversion pour votre projet VitePress. Claude suivra le protocole défini : il commence par identifier l'origine du dépôt git, puis produit le script complet adapté à votre contexte. Le script généré s'intègre ensuite via une entrée build:ado dans le package.json du projet cible.