Skill Article Publisher

MDX lint och semantic-commit git-publicering — trasigt i praktiken

av foreveryh · foreveryh/claude-skills-tutorial

Tested · Didn't pass

Skill Article Publisher — MDX lint och semantic-commit git-publicering — trasigt i praktiken

Vad den gör

Paketerar två Python-skript som påstår sig validera MDX-artiklar (frontmatter, escaped comparison operators, tag balance), köra en byggkontroll, generera ett Conventional-Commits-meddelande och pusha. Avsedd för fumadocs/Next.js dokumentationsrepos och utlöses av förfrågningar om att validera, committa eller publicera .mdx-filer. Vid exekvering missar valideraren verkliga MDX-kompileringsfel och den dokumenterade dry run skapar en faktisk commit.

Testrapport

Vi byggde ett fumadocs-stil repo med en avsiktligt trasig MDX-artikel och kompilerade den med @mdx-js/mdx för att få sanningen: två verkliga fel, en oavslutad <Callout> och en bar Promise<void> i prosa. Den paketerade validate_mdx.py fångade inget av dem, och flaggade istället två '>80% accuracy'-rader som kompilerar fint — vanlig `npm run build`, baslinjen utan färdighet, pekade ut båda verkliga felen med radnummer på ungefär en sekund. Värre är att den dokumenterade dry run inte är en dry run: att köra publish_article.py utan --push körde `git add -A` och skapade en verklig commit av 1658 filer, inklusive en .env.local som innehöll SECRET_TOKEN och hela node_modules-trädet, utan bekräftelseprompt. Ytterligare två exekverade fel: en ny ospårad artikel i katalogläge rapporterar 'No changes detected', och en relativ filväg kraschar med en ohanterad ValueError traceback. Installera den på det vanliga sättet, i ~/.claude/skills, och MDX-validering hoppas tyst över helt eftersom skriptet hårdkodar en uppslagning för .claude/skills/skill-article-publisher inuti målprojektet.

Testad: 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

Kommandon och exempelprompter

/skill-article-publisherMDX lint och semantic-commit git-publicering — trasigt i praktiken

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

Validate this MDX article and commit it with a conventional message
Check my new docs article for frontmatter and tag balance errors
Build and publish this fumadocs MDX article to the repo

Läs hela rapporten →