new-user_skill

Overview

This skill creates a new admin user in a Medusa project using the Medusa CLI. It accepts an email and password, runs the required Bash command, and returns a concise result summary with next steps. It is designed for use in development and local deployment workflows.

How this skill works

The skill runs the Bash command npx medusa user -e <email> -p <password> with the provided arguments to create an admin user. It captures the CLI output and any errors, then reports whether the creation succeeded, the created email, and relevant follow-up actions. If an error occurs, the skill surfaces the error text and suggests corrective steps.

When to use it

• Setting up a new local Medusa instance and needing an admin account.
• Onboarding developers who need admin access for testing and configuration.
• Automating environment provisioning in scripts or CI jobs.
• Recovering or recreating an admin account during development.

Best practices

• Use a strong, unique password for admin accounts and rotate regularly in non-production environments.
• Run the command from the Medusa project root so the environment and database config are correct.
• Avoid creating real production admin accounts on public CI runners; use environment-specific credentials.
• Check database connectivity and migrations before creating the user to prevent failures.
• Log CLI output and errors for auditability and troubleshooting.

Example use cases

• Create an admin for local testing: /medusa-dev:user admin@example.com supersecret.
• Provision demo environments with a default admin for QA access.
• Add an admin account as part of a developer onboarding script.
• Recreate admin after resetting the local database during development.