blog-validator

Validate MDX blog posts against SHARED.md rules and report issues.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Zero-1016/tech-blog --skill blog-validator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blog-validator
Source: https://github.com/Zero-1016/tech-blog/tree/main/.claude/skills/blog-validator
Command: npx skills add https://github.com/Zero-1016/tech-blog --skill blog-validator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It automates the tedious, error-prone task of validating MDX blog posts against formal frontmatter, structure, and content rules, helping writers maintain high quality with minimal manual effort.

Core Features & Use Cases

  • Frontmatter & Structure Validation: checks required fields, dates, and series rules to ensure consistency across posts.
  • Content Rule Enforcement: validates JSX balance, internal links, references, and MDX components, proposing safe fixes.
  • Guided Remediation: automatically applies deterministic fixes where possible and surfaces decisions requiring user input with structured options.

Quick Start

Run the validator on a target MDX file to surface issues, suggested fixes, and a report with actionable next steps.

Frequently Asked Questions about blog-validator

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

FAQPage Schema
How do I validate MDX blog posts for frontmatter and internal link errors?

MDX blog validation checks required frontmatter fields, dates, and series rules to ensure structural consistency, preventing publishing errors and maintaining content quality across blog posts with minimal manual review.

Can I automatically fix unbalanced JSX tags and broken references in MDX files?

Yes, guided remediation applies deterministic fixes to unbalanced JSX tags and broken references where possible, preserving author intent while surfacing remaining conflicts as structured user-action items.

What is the best way to enforce shared content rules across multiple MDX blog posts?

Applying SHARED.md rules during MDX validation enforces content consistency by checking frontmatter structure, JSX balance, and internal links, proposing safe fixes and escalating irreparable errors.

Does this validation tool check internal links and MDX component usage?

Yes, content rule enforcement validates internal links, references, and MDX components to ensure they meet formal structure rules, proposing safe fixes and flagging irreparable errors for escalation.

How do I handle MDX validation errors that cannot be auto-fixed?

Irreparable MDX validation errors are escalated through a structured report detailing specific user-action items, allowing writers to manually resolve complex frontmatter or content conflicts.