SkillsAdd

smithery/jackhuynh95

medusa-pro-max

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…

Installation

$ npx skills add smithery/jackhuynh95 --skill medusa-pro-max
View on skills.sh ↗ Website ↗

Summary

  • 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)

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
prisma-cli Shared topics
prisma/skills

Prisma ORM CLI commands reference covering init, generate, migrate, db, dev, complete, studio, …

267K installs
supabase Shared topics
supabase/agent-skills

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge F…

263K installs
vercel-react-best-practices Shared topics
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Shared topics
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Declared agents claude-code

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,328 B
  • docs SUMMARY.md 607 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

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