Medusa

This teaches Claude how to build with Medusa, the open-source headless commerce platform built on Node.js and TypeScript. You'd reach for this when you need an e-commerce backend that doesn't lock you into Shopify or similar hosted solutions. It covers the full stack: scaffolding projects with create-medusa-app, writing custom API routes in the src/api directory structure, building modules for business logic like reviews or loyalty systems, and creating workflows for multi-step processes like order fulfillment with rollback support. The skill includes realistic examples like calculating revenue analytics through the order service and setting up CORS for your Next.js storefront. If you want programmatic control over your commerce layer without rebuilding everything from scratch, this is the reference.

skills.sh installs: 186
GitHub stars: 685
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add alinaqi/claude-bootstrap --skill medusa --agent claude-code

Installs into .claude/skills of the current project.

Files

Medusa E-Commerce Skill

For building headless e-commerce with Medusa - open-source, Node.js native, fully customizable.

Sources: Medusa Docs | API Reference | GitHub

Why Medusa

Feature	Benefit
Open Source	Self-host, no vendor lock-in, MIT license
Node.js Native	TypeScript, familiar stack, easy to customize
Headless	Any frontend (Next.js, Remix, mobile)
Modular	Use only what you need, extend anything
Built-in Admin	Dashboard included, customizable

Quick Start

Prerequisites

# Required
node --version  # v20+ LTS
git --version
# PostgreSQL running locally or remote

Create New Project

# Scaffold new Medusa application
npx create-medusa-app@latest my-store

# This creates:
# - Medusa backend
# - PostgreSQL database (auto-configured)
# - Admin dashboard
# - Optional: Next.js storefront

cd my-store
npm run dev