Medusa Pro Max

An AI skill that brings deep workflow intelligence to Medusa.js v2 e-commerce development.

What It Does

Medusa Pro Max transforms your AI coding assistant into a Medusa.js expert. It provides instant access to architectural patterns, best practices, and production-ready implementations—enabling you to build robust e-commerce workflows with proper idempotency, compensation logic, and module isolation.

Features

Workflow Intelligence

Capability	Description
Architecture Guidance	Expert patterns for Saga workflows, reversible steps, and compensation handlers
V2 Documentation	Searchable access to current Medusa v2 patterns and standards
Best Practices	Curated rules for error handling, retry logic, and transactions
Module Design	Separation of concerns across modules, services, and subscribers
TypeScript Patterns	Type-safe implementations throughout

Loyalty Plugin (Included)

A complete loyalty system with gift cards and store credits:

• Gift Cards — CRUD operations, status tracking, multi-currency support
• Store Credits — Customer balance management with full transaction logging
• Checkout Integration — Apply gift cards and credits during checkout
• Order Automation — Auto-generate gift cards when gift card products are purchased
• Complete API — Admin and Store routes for all loyalty features
• Ready-to-Use Workflows — Gift card redemption, store credit refunds, and more

Installation

Prerequisites

Python 3.x is required for the search engine:

python3 --version

Setup

1. Create the skills directory in your project (if needed):

   mkdir -p .claude/skills

2. Copy these folders from this repository into your project:

   • .claude/skills/medusa-pro-max/
   • .claude/commands/medusa.md

Usage

The skill activates automatically when you ask Claude to work on Medusa.js tasks. Just describe what you need:

"Design a return workflow that handles inventory restoration and refund processing"

"Implement payment capture with compensation logic for failures"

"Refactor this service to follow Medusa v2 module architecture"

"Create a gift card redemption workflow"

"Design a workflow for applying store credits to cart"

How It Works

1. Detection — Claude recognizes your request as a Medusa.js task
2. Research — The skill searches for relevant patterns, rules, and documentation
3. Implementation — Claude generates code with proper idempotency and error handling

Project Structure

.claude/
├── commands/
│   └── medusa.md                # Slash command trigger
└── skills/
    └── medusa-pro-max/
        ├── SKILL.md             # Core skill documentation
        ├── SKILL-LOYALTY.md     # Loyalty plugin docs
        ├── data/
        │   ├── medusa-v2-docs.csv
        │   └── loyalty-plugin.csv
        └── scripts/
            ├── search.py        # Best practices queries
            ├── search_docs.py   # V2 documentation search
            └── search_loyalty.py # Loyalty feature search

Acknowledgments

Inspired by UI UX Pro Max, an AI skill for professional UI/UX design intelligence.

License

MIT