Skill Article Publisher
Lint MDX et publication git par commit sémantique — cassé en pratique
Tested · Didn't pass
Ce que fait
Intègre deux scripts Python qui prétendent valider les articles MDX (frontmatter, opérateurs de comparaison échappés, équilibre des balises), exécuter une vérification de build, générer un message Conventional-Commits et pousser. Destiné aux dépôts de documentation fumadocs/Next.js et se déclenche sur les demandes de validation, de commit ou de publication de fichiers .mdx. En exécution, le validateur manque de réelles erreurs de compilation MDX et le dry run documenté crée un commit réel.
Rapport de test
Nous avons construit un dépôt de style fumadocs avec un article MDX délibérément cassé et l'avons compilé avec @mdx-js/mdx pour obtenir la vérité terrain : deux erreurs réelles, un <Callout> non fermé et un Promise<void> nu en prose. Le validate_mdx.py intégré n'en a détecté aucune, et a plutôt signalé deux lignes '>80% accuracy' qui compilent bien — un simple `npm run build`, la version de base sans skill, a identifié les deux erreurs réelles avec les numéros de ligne en environ une seconde. Pire, le dry run documenté n'est pas un dry run : l'exécution de publish_article.py sans --push a exécuté `git add -A` et créé un commit réel de 1658 fichiers, y compris un .env.local contenant SECRET_TOKEN et tout l'arbre node_modules, sans invite de confirmation. Deux autres échecs exécutés : un nouvel article non suivi en mode répertoire signale 'No changes detected', et un chemin de fichier relatif plante avec un traceback ValueError non géré. Installez-le de la manière normale, dans ~/.claude/skills, et la validation MDX est silencieusement ignorée entièrement car le script code en dur une recherche de .claude/skills/skill-article-publisher à l'intérieur du projet cible.
Testé le: 2026-08-10 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/foreveryh/claude-skills-tutorial.git mkdir -p ~/.claude/skills cd claude-skills-tutorial && cp -r .claude/skills/skill-article-publisher ~/.claude/skills/skill-article-publisher
Commandes et exemples de prompts
/skill-article-publisherLint MDX et publication git par commit sémantique — cassé en pratique
Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :
Validate this MDX article and commit it with a conventional messageCheck my new docs article for frontmatter and tag balance errorsBuild and publish this fumadocs MDX article to the repo