Skill Article Publisher
MDX lint a semantic-commit git publikování – v praxi nefunkční
Tested · Didn't pass
Co umí
Obsahuje dva Python skripty, které tvrdí, že validují MDX články (frontmatter, escapované operátory porovnání, rovnováha tagů), spouští kontrolu sestavení, generují zprávu Conventional-Commits a pushují. Zaměřeno na repozitáře dokumentace fumadocs/Next.js a spouští se na požadavky na validaci, commit nebo publikování .mdx souborů. Při provádění validátor přehlíží skutečné MDX chyby kompilace a zdokumentovaný dry run vytváří skutečný commit.
Testovací report
Vytvořili jsme repozitář ve stylu fumadocs s jedním záměrně rozbitým MDX článkem a zkompilovali ho s @mdx-js/mdx, abychom získali základní pravdu: dvě skutečné chyby, neuzavřený <Callout> a holý Promise<void> v próze. Přibalený validate_mdx.py nezachytil ani jednu, a místo toho označil dva řádky '>80% accuracy', které se zkompilují v pořádku – prostý `npm run build`, základní verze bez dovednosti, přesně určil obě skutečné chyby s čísly řádků za zhruba sekundu. Horší je, že zdokumentovaný dry run není dry run: spuštění publish_article.py bez --push spustilo `git add -A` a vytvořilo skutečný commit 1658 souborů, včetně .env.local obsahujícího SECRET_TOKEN a celého stromu node_modules, bez potvrzovacího dotazu. Další dvě provedené chyby: nový nesledovaný článek v adresářovém režimu hlásí 'No changes detected' a relativní cesta k souboru havaruje s neošetřeným tracebackem ValueError. Nainstalujte ji běžným způsobem, do ~/.claude/skills, a validace MDX je zcela tiše přeskočena, protože skript pevně kóduje vyhledávání pro .claude/skills/skill-article-publisher uvnitř cílového projektu.
Testováno: 2026-08-10 · Claude Code 2.x (agent harness)
Instalace
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
Příkazy a ukázkové prompty
/skill-article-publisherMDX lint a semantic-commit git publikování – v praxi nefunkční
Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):
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