Medusa Agent Skills — Development skill for Claude Code
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
- 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
Related Skills
Bench Capture
Score the 2 bench variant folders for one size (build/acceptance/regression/conventions/capture + rubric + cro
Teach
View, add, or manage project conventions. Shows what VBW already knows and warns about conflicts.
Art 3D Pass
Review 3D art assets for export conventions, rigs, animation clips, materials, lighting, and LOD compliance.
Does This Clash
Analyze whether code fits with established codebase patterns and conventions
Naming Crusade
Unleash parallel Naming Purist agents to enforce file naming conventions, variable semantics, and code clarity
Workflows Plan
Transform feature descriptions into well-structured project plans following conventions
Related Agents
JavaScript
Modern JavaScript (ES6+) best practices and conventions. - wshobson/agents
Svelte Idiom Review
Reviews a feature segment in any SvelteKit app (apps/moderator, apps/auth, apps/creator-studio) for Svelte 5 i
React Effect Reviewer
Use to review React (.tsx) changes for the project's useEffect discipline and React conventions before merging