packages/serverpod/skills/serverpod-cli/SKILL.md
Serverpod CLI — serverpod create, generate, create-migration, and other commands. Use when generating code, creating migrations, or creating projects/modules.
npx skillsauth add serverpod/serverpod serverpod-cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Install: dart pub global activate serverpod_cli.
Run: from project root or server package directory.
serverpod create <project_name> # Full project (server, client, Flutter)
serverpod create --template module <name> # Module (server + client)
Project name: valid Dart package name (lowercase, underscores).
Regenerate client and server code from endpoints and .spy.yaml models.
serverpod generate
Run after adding or changing endpoints or models. Do not edit generated files.
Generate a database migration from model changes.
serverpod create-migration
Options: --force (override no-changes/data-loss checks), --tag "v1-0-0" (name tag).
Apply: dart run bin/main.dart --apply-migrations (or --role maintenance --apply-migrations for scripted runs).
Repair when DB was modified outside migrations. Compares live DB to migration system.
serverpod create-repair-migration
Options: --mode production, --version <migration-name>, --force, --tag.
Apply: dart run bin/main.dart --apply-repair-migration. Repair runs before normal migrations.
serverpod create my_app → start DB → run server with --apply-migrations → run Flutter appserverpod generateserverpod create-migration → run server with --apply-migrationsUse serverpod --help and serverpod <command> --help for all flags. In workspace/melos setups, run serverpod generate from root or with -d pointing to the server package.
development
Build highly distinctive, production-ready Flutter interfaces with exceptional design fidelity. Include this skill whenever a user requests Flutter widgets, screens, or full apps.
testing
Serverpod Authentication — Signing in users, verify if they are authenticated, assinging scopes (e.g., admin). Use when adding features that require the user to be signed in.
development
Serverpod web server (Relic) — REST APIs, webhooks, middleware, static files, server-rendered HTML, SPAs, Flutter web. Use when adding HTTP routes, serving web pages or web apps, intercepting requests, or working with the Relic web server.
tools
Serverpod overview — what it is, project structure, how to work with. Always use at least once when working with projects that use Serverpod.