New User
Bootstrap a Medusa admin account with email and password so you can log into the dashboard on a fresh dev install.
Overview
new-user is an agent skill for the Build phase that creates a Medusa admin user via the npx medusa user CLI.
Install
npx skills add https://github.com/medusajs/medusa-agent-skills --skill new-userWhat is this skill?
- Runs npx medusa user -e <email> -p <password> via allowed Bash tool
- Argument-hint: email and password from slash command or user message
- Reports success, email used, errors, and next login steps
- Scoped to medusa user CLI subcommand pattern
Adoption & trust: 1.3k installs on skills.sh; 185 GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You finished installing Medusa but cannot sign into the admin dashboard because no admin account exists yet.
Who is it for?
Indie devs on a fresh Medusa project who need one local or staging admin without clicking through custom scripts.
Skip if: Production user onboarding tied to SSO, bulk imports, or customer storefront accounts—this only creates admin users via CLI.
When should I use this skill?
User provides admin email and password to create a Medusa user or uses the medusa-dev user slash pattern.
What do I get? / Deliverables
A Medusa admin user exists for your email and you get confirmation plus login next steps.
- Created Medusa admin user
- CLI success or error report
Recommended Skills
Journey fit
How it compares
Single-purpose Medusa CLI wrapper, not a full identity or RBAC design skill.
Common Questions / FAQ
Who is new-user for?
Solo builders and small teams setting up Medusa headless commerce who need an initial admin login quickly.
When should I use new-user?
During Build backend setup immediately after Medusa is installed and before you configure products or ship to staging.
Is new-user safe to install?
It runs shell commands with passwords in arguments; review the Security Audits panel on this page and avoid using production secrets in chat logs.
SKILL.md
READMESKILL.md - New User
# Create Admin User Create a new admin user in Medusa with the specified email and password. The user will provide two arguments: - First argument: email address - Second argument: password For example: `/medusa-dev:user admin@test.com supersecret` Use the Bash tool to execute the command `npx medusa user -e <email> -p <password>`, replacing `<email>` with the first argument and `<password>` with the second argument. Report the results to the user, including: - Confirmation that the admin user was created successfully - The email address of the created user - Any errors that occurred - Next steps (e.g., logging in to the admin dashboard)