Skill Article Publisher

MDX lint og semantic-commit git-publisering — ødelagt i praksis

av foreveryh · foreveryh/claude-skills-tutorial

Tested · Didn't pass

Skill Article Publisher — MDX lint og semantic-commit git-publisering — ødelagt i praksis

Hva den gjør

Inkluderer to Python-skript som hevder å validere MDX-artikler (frontmatter, escaped comparison operators, tag balance), kjøre en byggesjekk, generere en Conventional-Commits-melding og pushe. Rettet mot fumadocs/Next.js dokumentasjonsrepoer og utløses av forespørsler om å validere, committe eller publisere .mdx-filer. Ved utførelse overser validatoren reelle MDX-kompileringsfeil, og den dokumenterte dry run oppretter en faktisk commit.

Testrapport

Vi bygget et fumadocs-stil-repo med én deliberately broken MDX article and compiled it with @mdx-js/mdx to get ground truth: two genuine errors, an unclosed <Callout> and a bare Promise<void> in prose. The bundled validate_mdx.py caught neither, and instead flagged two '>80% accuracy'-linjer som kompilerer fint — plain `npm run build`, the no-skill baseline, pinpointed both real errors with line numbers in about a second. Verre, den dokumenterte dry run is not a dry run: running publish_article.py without --push ran `git add -A` and created a real commit of 1658 files, including a .env.local holding SECRET_TOKEN and the whole node_modules tree, with no confirmation prompt. To ytterligere utførte feil: a new untracked article in directory mode reports 'No changes detected', and a relative file path crashes with an unhandled ValueError traceback. Installer den på vanlig måte, into ~/.claude/skills, and MDX validation is silently skipped entirely because the script hardcodes a lookup for .claude/skills/skill-article-publisher inside the target project.

Testet på: 2026-08-10 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

/skill-article-publisherMDX lint og semantic-commit git-publisering — ødelagt i praksis

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

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

Full rapport →