Skill Article Publisher
MDX lint and semantic-commit git publishing — broken in practice
Test report
- Verdict
- Tested · Didn't pass
- Tested
- Aug 10, 2026
- Environment
- Claude Code 2.x (agent harness)
We built a fumadocs-style repo with one 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' lines that compile fine — plain `npm run build`, the no-skill baseline, pinpointed both real errors with line numbers in about a second. Worse, the documented 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. Two more executed failures: a new untracked article in directory mode reports 'No changes detected', and a relative file path crashes with an unhandled ValueError traceback. Install it the normal way, 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.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 4/5
- Triggers reliably 5/5
- Output vs. baseline 2/10
- Docs & honesty 1/5
What Skill Article Publisher does
Bundles two Python scripts that claim to validate MDX articles (frontmatter, escaped comparison operators, tag balance), run a build check, generate a Conventional-Commits message and push. Aimed at fumadocs/Next.js documentation repos and triggers on requests to validate, commit or publish .mdx files. In execution the validator misses real MDX compile errors and the documented dry run creates an actual commit.
How to install Skill Article Publisher
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
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger Skill Article Publisher
-
/skill-article-publisherMDX lint and semantic-commit git publishing — broken in practice
It also activates on plain-language prompts like these:
-
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
Frequently asked questions
- Is the Skill Article Publisher skill free?
- Yes. The skill itself is free from foreveryh/claude-skills-tutorial. SkillProof publishes the install command and an independent test verdict at no cost.
- Does Skill Article Publisher work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Aug 10, 2026. Verdict: Tested · Didn't pass. We built a fumadocs-style repo with one 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' lines that compile fine — plain `npm run build`, the no-skill baseline, pinpointed both real errors with line numbers in about a second. Worse, the documented 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. Two more executed failures: a new untracked article in directory mode reports 'No changes detected', and a relative file path crashes with an unhandled ValueError traceback. Install it the normal way, 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.
- How do I install Skill Article Publisher?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use Skill Article Publisher with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.