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.csvby default.
- Usage:
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.
Converted and distributed by TomeVault — claim your Tome and manage your conversions.