What problem does it solve?
Creating Medusa documentation tutorials requires both a working code example and polished MDX documentation, and doing both at once often produces untested code samples or inconsistent docs. This Skill enforces a two-phase workflow that builds and tests the feature first, then writes the documentation.
Core Features & Use Cases
- Two-Phase Workflow: Phase 1 gathers requirements, plans, implements, and tests the tutorial feature in an example Medusa project; Phase 2 writes per-step MD files, combines them into a final MDX page, and updates the sidebar.
- Documentation Conventions: Provides pre-written templates for the installation step, frontmatter, summary sections, CardList components, WorkflowDiagram usage, code block attributes, and verbatim concept definitions (module, workflow, API route, module providers, and more).
- Use Case: When asked to create a how-to tutorial like "product reviews" or an integration guide like "PayPal payment provider", the Skill first builds and tests the feature in a Medusa app, then produces a complete
page.mdx with sidebar registration in the Medusa docs site.
Quick Start
Ask the agent to create a new Medusa how-to tutorial for a feature such as product reviews, providing the tutorial type and the path to your example Medusa project.
