medusa-deploy

medusa-deploy is a skill for Claude Code from OrcaQubits/agentic-commerce-skills-plugins. It costs 44 tokens per session (1,730 once invoked), scanned A, original, MIT.

A production deployment guide for Medusa v2, an e-commerce backend. It explains how to build the application, run database changes, and start the web server or background worker.

In plain words
What is it for?
Use it to prepare a Medusa application for hosting, configure production services, run migrations, and choose between server and worker processes.
Why use it?
It helps avoid deployment mistakes involving compiled files, environment settings, databases, Redis, and the separate processes that may run in production.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the medusa-commerce plugin — 19 skills, 1 agent shipped together

Good fit Use it to prepare a Medusa application for hosting, configure production services, run migrations, and choose between server and worker processes.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add OrcaQubits/agentic-commerce-skills-plugins --skill medusa-deploy
Clone the repo
git clone --depth 1 https://github.com/OrcaQubits/agentic-commerce-skills-plugins

Made for: Claude Code.

Or install medusa-commerce, the plugin that ships this one along with the rest of its 19 skills, 1 agent.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for medusa-deploy

README.md
[![agentmods](https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy/github.svg)](https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy)
Your own site
<a href="https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy"><img src="https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for medusa-deploy

Your own site · 80×15
<a href="https://agentmods.dev/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy"><img src="https://agentmods.dev/badge/skills/orcaqubits/agentic-commerce-skills-plugins/medusa-deploy.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 44 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,730 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.01730
Opus 5 $0.00022 $0.00865
Sonnet 5 $0.00009 $0.00346
Haiku 4.5 $0.00004 $0.00173

Measured 2d ago against content hash 40a5e4c8e646, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-16, from the pricing page.

Security

Grade A, and why

medusa-deploy scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

medusa-commerce/skills/medusa-deploy/SKILL.md · 194 lines

How it starts

The opening of the file, as written. The whole thing — 194 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Medusa v2 Deployment

Before writing code

Fetch live docs:

  1. Web-search site:docs.medusajs.com deployment production for production deployment guides
  2. Web-search site:docs.medusajs.com medusa build for build process details
  3. Fetch https://docs.medusajs.com/resources/medusa-cli for CLI command reference
  4. Web-search site:docs.medusajs.com environment variables configuration for env var reference
  5. Web-search site:docs.medusajs.com redis cache events for Redis caching and event bus setup

Build Process

Build Commands

Command Purpose
npx medusa build Compile server + admin dashboard for production
npx medusa db:migrate Run pending database migrations
npx medusa start Start the production server
npx medusa worker Start the background worker process

The build step compiles TypeScript, bundles admin extensions (Vite), and prepares the .medusa/ output directory.

Build Output Structure

.medusa/
├── server/           — Compiled server code
│   ├── src/          — Custom modules, routes, workflows
│   └── medusa-config.js
└── admin/            — Bundled admin dashboard (static)

Server vs Worker Mode

Medusa v2 supports running the server and background workers as separate processes:

Mode Command Handles
Server npx medusa start HTTP requests, API routes, admin dashboard
Worker npx medusa worker Workflows, scheduled jobs, event subscribers
Combined Default start behavior Both server and worker (single process)

When to Separate

  • Development — combined mode is fine
  • Production — separate for reliability and independent scaling
  • High traffic — scale server instances independently from workers
  • Worker mode requires Redis for job queue communication between processes

Environment Variables

Required Variables

Variable Purpose Example
DATABASE_URL PostgreSQL connection string postgres://user:pass@host:5432/medusa
COOKIE_SECRET Session cookie signing Random 32+ character string
JWT_SECRET JWT token signing Random 32+ character string
NODE_ENV Runtime environment production

Read the full file on GitHub · 194 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 194 lines · 44 tokens per session scan A 40a5e4c8e646

Subscribe to this mod's changes

medusa-deploy is a skill published in the GitHub repository OrcaQubits/agentic-commerce-skills-plugins (39 stars, last pushed 2d ago), licensed MIT. It adds 44 tokens to every session and 1,730 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-15.

Related

Other skills, from other repositories

archestra-dev-investigate

Use when investigating Archestra bugs or incidents — staging issues, backend 50x errors, Drizzle failed queries, DB connection pressure, deploy regressions, or Kubernetes/runtime symptoms. Orientation only; defers the process to /investigate.

archestra-ai/archestra · 54 tokens

0g-compute

0G Compute Network guide for decentralized AI inference, fine-tuning, and GPU services. Covers chatbots, image generation, speech-to-text, SDK integration (0g-serving-broker), processResponse API, broker.inference methods, CLI commands (0g-compute-cli), and account management. Use this skill for any 0G compute, 0G AI…

internet-court/internet-court-skill · 85 tokens

mppx

TypeScript SDK for the Payment HTTP Authentication Scheme. Handles 402 Payment Required flows with Tempo, Stripe, and other payment methods. Use when integrating payments or mppx into a client or server application.

internet-court/internet-court-skill · 45 tokens

cloud-claw-launch-agent

Use this skill when the user wants to launch a new AltClaw, OpenClaw, PicoClaw, or Ottie deployment through Cloud Claw. Covers the same user-facing fields and constraints exposed in the Cloud Claw UI, using the local altllm cloud-claw- commands. Do NOT use for post-launch lifecycle tasks like start/stop/delete/logs…

internet-court/internet-court-skill · 91 tokens

cloud-claw

Use this umbrella skill when the request spans multiple Cloud Claw user-facing domains, especially launching a new AltClaw or OpenClaw VM and then managing lifecycle, logs, renewal, or dashboard access through the local altllm cloud-claw- commands in this repository.

internet-court/internet-court-skill · 59 tokens

mcloud-logs

Execute mcloud logs to fetch and stream runtime logs for Cloud environments. Use when reading backend or storefront logs, filtering by time range, searching for errors, or scoping logs to a specific deployment.

medusajs/medusa-agent-skills · 45 tokens