What makes this skill different from a general tutorial generator?

It is specifically tuned for the Medusa framework, enforcing a strict 4-6 step 'recipe' format, specific file path conventions, and adherence to Medusa's internal Vale style rules.

Can I use this for non-Medusa projects?

While the format is general, the skill is heavily optimized for Medusa's brand guidelines, terminology (e.g., 'Workflows SDK'), and internal documentation structure.

Does it research my actual project code?

Yes, the skill searches the packages directory to identify the specific services, workflows, and APIs needed for the task you are documenting.

What kind of documentation output does it produce?

It generates MDX files with full frontmatter, product tags, sidebar labels, and specialized components like npm2yarn blocks and custom Medusa UI callouts.

Medusa How-to Guide Writer

Name: Medusa How-to Guide Writer
Author: medusajs

bymedusajs

•

31,823

•

Learning & Documentation

Generates concise, task-oriented technical guides for the Medusa ecommerce platform following standardized documentation patterns.

This skill empowers developers and technical writers to create high-quality, focused how-to guides for the Medusa ecosystem. It automates the research of implementation patterns within the Medusa codebase, enforces strict Vale style guidelines for consistent terminology, and generates standardized MDX files complete with frontmatter, actionable code blocks, and testing instructions. It is designed to produce 'recipes' that developers can complete in 10-20 minutes, ensuring documentation is practical, code-heavy, and easy to follow.

Key Features

01Integrates specialized UI components like Note, CodeTabs, and Badges

0231,823 GitHub stars

03Supports cross-project linking using Medusa's proprietary documentation syntax

04Generates standardized 4-6 step how-to guides in MDX format

05Automates codebase research to identify relevant services and workflows

06Enforces Medusa-specific Vale style compliance and terminology

Use Cases

01Standardizing documentation style across a Medusa-based project

02Documenting specific commerce workflows or API implementations

03Creating quick-start 'recipes' for common developer tasks in Medusa

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add medusajs/medusa how-to

For use in Claude.ai and ChatGPT

Download Skill