medusa-agent-skills
Agent skills and commands for Medusa best practices and conventions.
In the AI payments ecosystem
medusa-agent-skills is an established JavaScript project in the AI payments / x402 ecosystem, focused on agentic-commerce, claude, claude-code, commerce. It currently has 202 GitHub stars and 25 forks, and sits alongside related tools like internet-court-skill, mcp-dev-latam, awesome-agentic-commerce, codex-claude-bridge, agentic-commerce-skills-plugins, routeweiler-python-sdk.
Our take
Agent skills and commands for Medusa — the popular open-source commerce platform — encoding its best practices and conventions so coding agents can build Medusa storefronts and backends correctly. It sits at the intersection of agentic tooling and real e-commerce infrastructure.
Its relevance to agent payments is directional: as commerce platforms like Medusa expose agent-ready skills, they become the surface where agentic checkout and machine purchasing will actually be wired in. Backed by the Medusa project itself, this is a credible signal of where mainstream commerce is meeting the agent stack.
Best for: teams building on Medusa who want agents to follow its conventions, and anyone tracking how established commerce platforms adopt agentic workflows.
Medusa Agent Skills
A collection of skills composed as Claude Code plugins for building Medusa applications with best practices and architectural patterns.
These skills can be used with any agent, as explained in the Usage with Other Agents section.
Available Plugins
| Plugin | Description |
|---|---|
| medusa-dev | Comprehensive skills for building Medusa applications across backend, admin UI, and storefronts. |
| learn-medusa | Interactive tutorial session to learn about Medusa concepts through building a brands feature. |
| ecommerce-storefront | Comprehensive skill for building high-converting ecommerce storefronts with best practices. |
| medusa-cloud | Skills for managing Medusa Cloud resources through the Cloud CLI (mcloud). |
Installation for Claude Code
- Start Claude:
claude
- Add the Medusa marketplace to Claude Code:
/plugin marketplace add medusajs/medusa-agent-skills
- Install any of the plugins. For example:
/plugin install medusa-dev@medusa
- Verify the plugin is loaded:
/plugin
You should see the Medusa plugin listed under the Installed tab.
Usage with Other Agents
Installation with skills
The skills command allows you to copy skills from a repository to the directory relevant for your agent. Use this command when you only want to copy skills, as you can't copy the MCP server with this command.
yarn skills add medusajs/medusa-agent-skills
Manual Installation
Alternatively, you can copy the assets necessary, including skills and MCP servers, to the directory relevant to your agent.
For example, if you're using Cursor and you want to use the medusa-dev plugin, you can:
- Copy the skills directories to the .cursor/skills directory of your Medusa project.
- Add the MCP server configuration to the .cursor/mcp.json file of your Medusa project.
Usage
These plugins will help you with your Medusa development. Refer to each plugin for more details on usage.
Privacy
The Medusa plugins do not collect, store, or transmit any user data or conversation information. All instructional content is provided locally through skill files, and MCP servers only query public Medusa documentation.
Similar projects
The trust layer for agent-to-agent commerce — natural-language mandates, ERC-7710 delegated permissions, x402 payments, escrow, and dispute resolution as one open, catch-all Agent Skill / Claude Code plugin.
Open-source MCP servers for Latin American commerce — Pix, NF-e, banking, fiscal, logistics, and messaging across Brazil, Mexico, Argentina, Colombia, Chile, and Peru. MIT, on npm.
A curated list of awesome agentic commerce resources — protocols, MCP servers, tools, apps, APIs and services for AI agents that shop, sell and transact. For store owners, developers, agencies and marketers.
Bidirectional bridge between Claude Code and OpenAI Codex CLI. Built on Claude Code Channels. Two AI agents, one conversation, real-time web UI.
Skills & plugins for agentic commerce : UCP, ACP, AP2, A2A, WebMCP, Magento 2, BigCommerce, WooCommerce
The financial operating system for AI agents. A single HTTP client that intercepts '402 Payment Required', routes across x402, L402, and MPP, persists credentials as recoverable assets, enforces per-envelope budgets, and emits a structured trace.
More Claude projects
All Claude projects →
The agent-native LLM router for autonomous agents. 55+ models (8 free), <1ms local routing, USDC payments on Base & Solana via x402.
The living ecosystem where AI agents complete tasks through workflow loops, improve through iterative execution, are evaluated by mentor agents or humans in the loop, and turn completed work into reusable work experience and data to improve future agents.
The living ecosystem where AI agents complete tasks through workflow loops, improve through iterative execution, are evaluated by mentor agents or humans in the loop, and turn completed work into reusable work experience and data to improve future agents.
Open Source AI trading agent that operates autonomously across 1000+ markets - Polymarket, Kalshi, Binance, Hyperliquid, Solana DEXs, 5 EVM chains. Scans for edge, executes instantly, manages risk while you sleep. Agent commerce protocol for machine-to-machine payments. Self-hosted. Built on Claude.
Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-call via x402 micropayments.
Beacon - agent-to-agent pings with optional RTC value attached (BoTTube/Moltbook/RustChain + UDP bus)
