Skill Article Publisher
Lint MDX e pubblicazione git semantic-commit — rotto nella pratica
Tested · Didn't pass
Cosa fa
Include due script Python che affermano di validate MDX articles (frontmatter, escaped comparison operators, tag balance), run a build check, generate a Conventional-Commits message e push. Destinato a fumadocs/Next.js documentation repos e si attiva su richieste di validate, commit o publish .mdx files. In esecuzione il validator misses real MDX compile errors e il documented dry run creates an actual commit.
Rapporto di test
Abbiamo costruito un repo in stile fumadocs con un MDX article deliberatamente rotto e l'abbiamo compilato con @mdx-js/mdx per ottenere la ground truth: due genuine errors, un unclosed <Callout> e un bare Promise<void> in prosa. Il bundled validate_mdx.py non ha rilevato nessuno dei due, e invece ha segnalato due linee '>80% accuracy' che compilano bene — plain `npm run build`, la no-skill baseline, ha individuato entrambi i real errors con line numbers in circa un secondo. Peggio, il documented dry run non è un dry run: l'esecuzione di publish_article.py senza --push ha eseguito `git add -A` e ha creato un real commit di 1658 files, incluso un .env.local che conteneva SECRET_TOKEN e l'intero node_modules tree, senza confirmation prompt. Altri due executed failures: un new untracked article in directory mode riporta 'No changes detected', e un relative file path crash con un unhandled ValueError traceback. Installalo nel modo normale, in ~/.claude/skills, e la MDX validation è silenziosamente saltata del tutto perché lo script hardcodes una lookup per .claude/skills/skill-article-publisher all'interno del target project.
Testato il: 2026-08-10 · Claude Code 2.x (agent harness)
Installazione
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
Comandi e prompt di esempio
/skill-article-publisherLint MDX e pubblicazione git semantic-commit — rotto nella pratica
Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):
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