> **building-with-medusa** — skill 14 of 18 in [medusajs/medusa-agent-skills](https://skillsdocs.com/medusajs/medusa-agent-skills).
>
> Book (all skills, one file): https://skillsdocs.com/medusajs/medusa-agent-skills.md
> Machine manifest: https://skillsdocs.com/medusajs/medusa-agent-skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add medusajs/medusa-agent-skills`
> Upstream: https://github.com/medusajs/medusa-agent-skills/blob/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/
> Licence: No licence detected — all rights reserved by its authors
>
> Bundled files (13), referenced from this skill's directory:
>   - `reference/api-routes.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/api-routes.md
>   - `reference/authentication.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/authentication.md
>   - `reference/custom-modules.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/custom-modules.md
>   - `reference/data-models.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/data-models.md
>   - `reference/error-handling.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/error-handling.md
>   - `reference/frontend-integration.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/frontend-integration.md
>   - `reference/module-links.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/module-links.md
>   - `reference/querying-data.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/querying-data.md
>   - `reference/scheduled-jobs.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/scheduled-jobs.md
>   - `reference/subscribers-and-events.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/subscribers-and-events.md
>   - `reference/troubleshooting.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/troubleshooting.md
>   - `reference/workflow-hooks.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/workflow-hooks.md
>   - `reference/workflows.md` — https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/reference/workflows.md
>
> Content © its authors. This skill's body is not served here; the links above are. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request

# building-with-medusa

Load automatically when planning, researching, or implementing ANY Medusa backend features (custom modules, API routes, workflows, data models, module links, business logic). REQUIRED for all Medusa backend work in ALL modes (planning, implementation, exploration). Contains architectural patterns, best practices, and critical rules that MCP servers don't provide.

No licence could be detected for this skill at either the repository or the skill level, so its body is not reproduced here. Read it upstream:

https://raw.githubusercontent.com/medusajs/medusa-agent-skills/main/plugins/medusa-dev/skills/building-with-medusa/SKILL.md