skills.rest
wlfmnstr
wlfmnstrCOMMUNITY
Explore all skills by this author →
GitHub

mdx-content

Design Zod frontmatter schemas and MDX processing pipelines for documentation sites.

Updated Nov 5, 2025
One-click install
npx skills add https://github.com/wlfmnstr/agentic-knowledge-base --skill mdx-content
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mdx-content
Source: https://github.com/wlfmnstr/agentic-knowledge-base/tree/main/.claude/skills/mdx-content
Command: npx skills add https://github.com/wlfmnstr/agentic-knowledge-base --skill mdx-content

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides patterns for designing robust content schemas and configuring MDX processing, enabling you to create rich, interactive, and type-safe documentation. It streamlines content management for knowledge bases and blogs, reducing errors and improving authoring efficiency.

Core Features & Use Cases

  • Type-Safe Content Schemas: Define frontmatter schemas with Zod for validation and autocomplete, catching errors at build time.
  • Advanced MDX Configuration: Integrate essential Remark and Rehype plugins for GitHub Flavored Markdown, syntax highlighting, and auto-linked headings.
  • Use Case: Set up a new documentation site using MDX, defining a strict frontmatter schema for all articles, configuring syntax highlighting for code blocks, and enabling automatic Table of Contents generation to save manual effort.

Quick Start

Explain how to define a type-safe frontmatter schema for MDX content using Zod, including required fields like title and description, and optional fields like date and tags.

Frequently Asked Questions about mdx-content

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

FAQPage Schema
How do I set up type-safe frontmatter validation for MDX content?▼

Define frontmatter schemas using Zod to validate MDX document metadata at build time. Specify required fields like `title` and `description`, optional fields like `date` and `tags`, and gain autocomplete and type safety across your documentation site.

What MDX plugins should I configure for a documentation site?▼

Integrate remark-gfm for GitHub Flavored Markdown support and rehype plugins for syntax highlighting and auto-linked headings. These plugins enhance code-block styling, enable automatic Table of Contents generation, and improve readability in documentation.

How do I organize and structure MDX content for a knowledge base?▼

Organize content using directory and collection structures aligned with your frontmatter schema. This setup enables consistent metadata handling, build-time validation, and structured navigation across documentation and internal docs.

Can I validate MDX schemas at build time to catch errors early?▼

Yes. Build-time validation using Zod schemas catches metadata errors before deployment, reducing publishing mistakes and ensuring all MDX documents conform to your defined structure and required fields.

What's the difference between frontmatter patterns and MDX plugin configuration?▼

Frontmatter patterns define document metadata structure and validation rules; MDX plugin configuration handles content processing—syntax highlighting, markdown rendering, and component provisioning—to transform raw MDX into styled, interactive output.

Related Skills

foreveryhforeveryh
14

fumadocs-article-importer

Import external articles into Fumadocs with translation, classification, and MDX output.

Community
Advanced
ChegginCheggin
1

blog-scaffolder

Generate an SEO-optimized blog system with MDX posts, RSS feeds, and sitemaps.

Community
Advanced
TW-NLPTW-NLP
91

web-artifacts-builder

Create interactive HTML artifacts from React projects with Tailwind CSS and shadcn/ui.

Community
Advanced
leaderiopleaderiop
7

Documentation Docusaurus

Enforce Docusaurus coding standards across MDX/Markdown content, configuration, and navigation.

Community
Intermediate