Skill Article Publisher
MDX-Lint und semantisches Commit-Git-Publishing – in der Praxis fehlerhaft
Tested · Didn't pass
Was es kann
Bündelt zwei Python-Skripte, die MDX-Artikel (Frontmatter, escapte Vergleichsoperatoren, Tag-Balance) validieren, einen Build-Check ausführen, eine Conventional-Commits-Nachricht generieren und pushen sollen. Ziel sind fumadocs/Next.js-Dokumentations-Repos und wird bei Anfragen zum Validieren, Committen oder Veröffentlichen von .mdx-Dateien ausgelöst. Bei der Ausführung übersieht der Validator echte MDX-Kompilierungsfehler und der dokumentierte Dry Run erstellt einen tatsächlichen Commit.
Testbericht
Wir haben ein fumadocs-ähnliches Repo mit einem absichtlich fehlerhaften MDX-Artikel erstellt und es mit @mdx-js/mdx kompiliert, um die Wahrheit zu erfahren: zwei echte Fehler, ein ungeschlossenes <Callout> und ein nacktes Promise<void> in Prosa. Das gebündelte validate_mdx.py fing keines davon ab und kennzeichnete stattdessen zwei '>80% accuracy'-Zeilen, die einwandfrei kompilieren – ein einfaches `npm run build`, die Baseline ohne Skill, identifizierte beide echten Fehler mit Zeilennummern in etwa einer Sekunde. Schlimmer noch, der dokumentierte Dry Run ist kein Dry Run: Das Ausführen von publish_article.py ohne --push führte `git add -A` aus und erstellte einen echten Commit von 1658 Dateien, einschließlich einer .env.local, die SECRET_TOKEN enthielt, und des gesamten node_modules-Baums, ohne Bestätigungsaufforderung. Zwei weitere ausgeführte Fehler: Ein neuer, nicht verfolgter Artikel im Verzeichnismodus meldet 'No changes detected', und ein relativer Dateipfad stürzt mit einem unbehandelten ValueError-Traceback ab. Installieren Sie es auf die normale Weise, in ~/.claude/skills, und die MDX-Validierung wird vollständig stillschweigend übersprungen, da das Skript eine Suche nach .claude/skills/skill-article-publisher innerhalb des Zielprojekts fest codiert.
Getestet am: 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
Befehle & Beispiel-Prompts
/skill-article-publisherMDX-Lint und semantisches Commit-Git-Publishing – in der Praxis fehlerhaft
Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):
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