All Skills

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)

J
$npx skills add jackhuynh95/medusa-pro-max-skill --skill medusa-pro-max

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.