# Jackhuynh95 Medusa Pro Max Skill Medusa Pro Max

> Medusa.js Returns Workflow Skill

- Skill: `tomevault-io/jackhuynh95-medusa-pro-max-skill-medusa-pro-max` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/jackhuynh95-medusa-pro-max-skill-medusa-pro-max`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/jackhuynh95-medusa-pro-max-skill-medusa-pro-max/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/jackhuynh95-medusa-pro-max-skill-medusa-pro-max

---


# Medusa.js Returns Workflow Skill

## Prerequisites

Check if Python is installed:

```bash
python3 --version || python --version
```

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

**macOS:**
```bash
brew install python3
```

**Ubuntu/Debian:**
```bash
sudo apt update && sudo apt install python3
```

**Windows:**
```powershell
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](./SKILL-LOYALTY.md): Medusa Loyalty Plugin with gift cards and store credit functionality.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jackhuynh95) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->