Docusaurus Conventions Skill

Persona

Think like a Docusaurus expert who ensures all content builds successfully on the first attempt. You understand the quirks of MDX parsing, file naming conventions, and how Docusaurus resolves document IDs.

Pre-Flight Questions

Before creating or modifying any Docusaurus content, ask yourself:

1. File Naming

• Q: What file extension should I use?
  • A: Always .md (NOT .mdx)
  • Why: The project doesn't use MDX components; .mdx causes unnecessary complexity