Building With Medusa
If you're building anything on Medusa's backend, load this before you start. It enforces the critical architecture pattern (modules feed workflows, workflows feed API routes, routes feed frontend) and catches the mistakes that break Medusa apps: calling services directly from routes, skipping workflows for mutations, using PUT/PATCH methods, or treating prices like they're stored in cents when they're not. The skill itself is a quick reference with six rule categories, but the real value is that it forces you to load the actual reference files (custom modules, workflows, API routes) before implementing. Think of it as a checklist that prevents you from writing code that compiles but violates Medusa's architectural assumptions.
- skills.sh installs
- 4.8K
- GitHub stars
- 236
- last updated
- Aug 21, 2026
Install
$ npx -y skills add medusajs/medusa-agent-skills --skill building-with-medusa --agent claude-codeInstalls into .claude/skills of the current project.
Files
Medusa Backend Development
Comprehensive backend development guide for Medusa applications. Contains patterns across 6 categories covering architecture, type safety, business logic placement, and common pitfalls.
When to Apply
Load this skill for ANY backend development task, including:
- Creating or modifying custom modules and data models
- Implementing workflows for mutations
- Building API routes (store or admin)
- Defining module links between entities
- Writing business logic or validation
- Querying data across modules
- Implementing authentication/authorization
Also load these skills when:
- building-admin-dashboard-customizations: Building admin UI (widgets, pages, forms)
- building-storefronts: Calling backend API routes from storefronts (SDK integration)
CRITICAL: Load Reference Files When Needed
The quick reference below is NOT sufficient for implementation. You MUST load relevant reference files before writing code for that component.
Load these references based on what you're implementing:
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/medusajs/medusa-agent-skills
- Categories
- Backend & APIs, AI & Agent Building, Productivity & Planning
More from medusajs/medusa-agent-skills
All 15Recommended
More Backend & APIs
atlassian-mcpjeffallan/claude-skillsIntegrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and u4.6Kskills.sh installs
clawdirect-devnapoleond/clawdirectBuild agent-facing web experiences with ATXP-based authentication, following the ClawDirect pattern. Use this skill when building websites that AI agents intera4.6Kskills.sh installs
ios-networkingdpearson2699/swift-ios-skillsBuild, review, or improve networking code in iOS/macOS apps using URLSession with async/await, structured concurrency, and modern Swift patterns. Use when worki4.6Kskills.sh installs
zsxq-sharedunnoo/zsxq-skill知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作的安全4.6Kskills.sh installs
testinggrafana/skillsProbe, load-test, and instrument frontends from Grafana Cloud. Covers Synthetic Monitoring (HTTP / DNS / TCP / Ping / Traceroute / Multihttp / k6-browser script4.5Kskills.sh installsdjango-expertjeffallan/claude-skillsUse when building Django web applications or REST APIs with Django REST Framework. Invoke when working with settings.py, models.py, manage.py, or any Django pro4.5Kskills.sh installs