Skill Article Publisher
Lint MDX i publikowanie git z semantycznymi commitami — w praktyce zepsute
Tested · Didn't pass
Co robi ten skill
Zawiera dwa skrypty Python, które twierdzą, że walidują artykuły MDX (frontmatter, ucieknięte operatory porównania, balans tagów), uruchamiają kontrolę kompilacji, generują wiadomość Conventional-Commits i pushują. Skierowane do repozytoriów dokumentacji fumadocs/Next.js i uruchamia się na żądania walidacji, commitowania lub publikowania plików .mdx. W praktyce walidator pomija rzeczywiste błędy kompilacji MDX, a udokumentowane suche uruchomienie tworzy rzeczywisty commit.
Raport z testu
Zbudowaliśmy repozytorium w stylu fumadocs z jednym celowo uszkodzonym artykułem MDX i skompilowaliśmy go za pomocą `@mdx-js/mdx`, aby uzyskać prawdę: dwa prawdziwe błędy, niezamknięty `<Callout>` i goły `Promise<void>` w prozie. Dołączony `validate_mdx.py` nie wychwycił żadnego z nich, a zamiast tego oznaczył dwie linie '>80% accuracy', które kompilują się poprawnie — zwykłe `npm run build`, wersja bazowa bez umiejętności, wskazała oba prawdziwe błędy z numerami linii w około sekundę. Co gorsza, udokumentowane suche uruchomienie nie jest suchym uruchomieniem: uruchomienie `publish_article.py` bez `--push` uruchomiło `git add -A` i stworzyło prawdziwy commit 1658 plików, w tym `.env.local` zawierający `SECRET_TOKEN` i całe drzewo `node_modules`, bez monitu o potwierdzenie. Dwie kolejne wykonane awarie: nowy, nieśledzony artykuł w trybie katalogu zgłasza 'No changes detected', a względna ścieżka pliku powoduje awarię z nieobsłużonym śladem `ValueError`. Zainstaluj go w normalny sposób, do `~/.claude/skills`, a walidacja MDX jest całkowicie cicho pomijana, ponieważ skrypt na stałe koduje wyszukiwanie `.claude/skills/skill-article-publisher` wewnątrz projektu docelowego.
Testowano: 2026-08-10 · Claude Code 2.x (agent harness)
Instalacja
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
Komendy i przykładowe prompty
/skill-article-publisherLint MDX i publikowanie git z semantycznymi commitami — w praktyce zepsute
Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):
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