medusajs

Medusa Agent Skills — Development skill for Claude Code

Development community

Agent skills and commands for Medusa best practices and conventions.

How to install Medusa Agent Skills

This entry records only its repository, not the path inside it, so there is no exact command to give. Open medusajs/medusa-agent-skills and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Medusa Agent Skills does

Agent skills and commands for Medusa best practices and conventions.

Alternatives in Development

  • Theme Color Conventions — Extensions in this repo use a consistent color language mapped to Pi's theme tokens 526 ★
  • Conventions — codeck skill authoring conventions 204 ★
  • Create Actor — Create a new actor document following the Actor→Role→Interaction hierarchy and proper conventions 85 ★

README

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](#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

  1. Start Claude:
claude
  1. Add the Medusa marketplace to Claude Code:
/plugin marketplace add medusajs/medusa-agent-skills
  1. Install any of the plugins. For example:
/plugin install medusa-dev@medusa
  1. 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