Convert Word to Markdown
Ce skill fait partie du repository communautaire github/awesome-copilot, une collection de skills, agents et instructions pour enrichir l'expérience GitHub Copilot. Son rôle est précis : dès qu'un fichier .docx doit être lu, analysé, résumé ou comparé, il orchestre la conversion vers Markdown avant tout traitement, car le format .docx (bundle XML zippé) n'est pas fiable en lecture directe.
Ce que fait ce skill
Le skill demande à l'agent d'invoquer le script scripts/convert_word_to_md.py (basé sur la librairie Python markitdown) plutôt que de tenter de parser le fichier à la main. La conversion produit un dossier <nom>/ contenant le fichier .md généré ainsi qu'un sous-dossier img/ pour les images extraites du document. Il supporte le traitement unitaire comme le traitement par lot (dossier entier, avec option --recursive).
Le skill définit également des règles de coordination avec ses skills frères : lorsqu'un dossier contient plusieurs types de fichiers supportés (.pdf, .xlsx, .docx), il doit être invoqué en parallèle avec convert-pdf-to-md et convert-excel-to-md pour qu'aucun type de fichier ne soit silencieusement ignoré.
Structure et mise en place
Le dossier du skill contient le script de conversion, un fichier references/setup.md décrivant les prérequis (Python, pip, markitdown), et le SKILL.md lui-même qui sert d'instruction principale pour l'agent. La configuration de l'environnement — installation de markitdown — doit être réalisée une fois par environnement en suivant ce guide de setup.
Pour utiliser ce skill dans votre propre configuration Copilot, référez-vous à la documentation du repository github/awesome-copilot sur la façon d'intégrer un skill dans un agent ou un plugin.