skill-article-publisher

Validate MDX articles, run npm builds, and publish via git.

14|2|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/foreveryh/claude-skills-tutorial --skill skill-article-publisher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-article-publisher
Source: https://github.com/foreveryh/claude-skills-tutorial/tree/main/.claude/skills/skill-article-publisher
Command: npx skills add https://github.com/foreveryh/claude-skills-tutorial --skill skill-article-publisher

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the end-to-end workflow for validating, building, and publishing MDX documentation, eliminating manual steps and ensuring consistent git history.

Core Features & Use Cases

  • MDX Validation: Validate syntax and YAML frontmatter for MDX articles.
  • Build Verification: Run npm build to ensure MDX compiles.
  • Semantic Commits: Generate conventional commit messages for multi-language publications.
  • Multi-language Support: Detect en, zh, fr variants and publish together.
  • Git Push Automation: Staging, committing, and pushing changes to remote repositories.
  • Dry Run: Preview changes before actually committing or pushing.
  • Usage Examples: See the examples directory for workflows and outputs.

Quick Start

Use this skill to validate and publish MDX articles:

  • cd .claude/skills/skill-article-publisher
  • python scripts/validate_mdx.py content/docs/en/development/article.mdx
  • python scripts/publish_article.py content/docs/en/development/article.mdx --push

Frequently Asked Questions about skill-article-publisher

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate MDX validation and git publishing for my documentation?

MDX validation and git publishing are automated by running Python scripts to validate frontmatter, executing npm build checks, generating semantic commits, and pushing changes directly to remote repositories.

What does an automated MDX publishing workflow check before committing?

An automated MDX publishing workflow checks MDX syntax, validates YAML frontmatter, and runs npm build verification to ensure the article compiles successfully before staging and committing changes.

How do I generate semantic commits for multi-language MDX articles?

To generate semantic commits for multi-language MDX articles, the automation script detects language variants like en, zh, and fr, then creates conventional commit messages to publish them together.

Do I need both Python and Node.js installed to validate and publish MDX files?

Yes, you need both Python and Node.js installed. The solution relies on Python for MDX validation scripts and Node.js with npm to execute the build verification steps.

Can I preview MDX validation and publishing changes before pushing to a remote repository?

Yes, you can preview changes before pushing to a remote repository by using the dry run feature, which simulates validation, build checks, and commit generation without modifying git history.

What is the best way to handle MDX build errors during automated article publishing?

The best way to handle MDX build errors during automated publishing is to run the validation script first to catch syntax and frontmatter issues, then use npm build verification to ensure compilation succeeds before committing.