name

medusa-pro-max

description

Medusa.js workflow intelligence. Returns processing, refunds, order management, e-commerce workflows. Actions: design, implement, search, generate, review, optimize, debug, structure, architect, refactor workflow code. Components: workflow steps, compensation logic, hooks, modules, services, API routes, subscribers. Patterns: idempotent steps, reversible workflows, long-running tasks, saga pattern, error handling, retry logic. Topics: Medusa.js, workflow API, step functions, module architecture, database transactions, event-driven design, TypeScript, PostgreSQL, Redis. (project)

Medusa.js Returns Workflow Skill

Prerequisites

Check if Python is installed:

python3 --version || python --version

If Python is not installed, install it based on user's OS:

macOS:

brew install python3

Ubuntu/Debian:

sudo apt update && sudo apt install python3

Windows:

winget install Python.Python.3.12

Description

This skill assists in designing and implementing a Returns Workflow for Medusa.js, following official best practices and architectural patterns.

Capabilities

Best Practices Lookup: Quickly find guidelines for Workflows, Modules, and Configuration.
Documentation Search: Query the knowledge base for Medusa v2 patterns and references.
Workflow Design: Step-by-step guidance on designing idempotent, reversible workflows.
Implementation Support: Generate boilerplate and logic for Medusa Workflows.

Tools

search.py: Search the best practices database (CSV).
- Usage: python3 .claude/skills/medusa-pro-max/scripts/search.py "keyword"
- Note: Uses medusa-v2-docs.csv by default.

Data Sources

.claude/skills/medusa-pro-max/data/medusa-best-practices.csv: Curated list of best practices derived from official documentation.
.claude/skills/medusa-pro-max/data/medusa-v2-docs.csv: Comprehensive documentation, implementation rules, and architectural standards in structured CSV format.
.claude/skills/medusa-pro-max/data/loyalty-plugin.csv: Loyalty plugin features including gift cards and store credit.

Additional Skills

SKILL-LOYALTY.md: Medusa Loyalty Plugin with gift cards and store credit functionality.