Agent Skills
Give your AI coding agent up-to-date Prisma knowledge with installable skills
AI coding agents often struggle with Prisma: they generate outdated v6 patterns, hallucinate APIs, and miss breaking changes like ESM-only support and required driver adapters. Prisma Skills fix this by giving your agent accurate, version-specific knowledge it can reference automatically.
Skills are packaged instructions that follow the open Agent Skills format. Once installed, your agent uses them whenever it detects a relevant task, no prompting required.
Prisma ships skills from three places, matched to what you are building:
| You are working with | Where the skills come from | Install command |
|---|---|---|
| Prisma ORM v7, Prisma Postgres, Prisma Compute | prisma/skills | npx skills add prisma/skills |
| Prisma ORM 8 | ships inside the @prisma/orm-* packages | npx prisma@latest init |
| Prisma Composer | ships inside the @prisma/composer package | npx prisma skills sync |
Install
Add all skills from the main registry to your project:
bunx skills add prisma/skillsOr install only the ones you need:
bunx skills add prisma/skills --skill prisma-client-apiThe Prisma ORM CLI's skills commands do not install from this registry. They sync the skills that ship inside the Prisma ORM packages a project installs, so use npx skills add prisma/skills directly for the v7 skills above.
Skills are compatible with any agent that supports the Agent Skills format, including Claude Code, Cursor, Codex, Windsurf, and others.
Available skills
prisma-cli
Complete reference for all Prisma CLI commands in v7.
Covers init, generate, dev, migrate dev, migrate deploy, db push, db pull, db seed, studio, and more. Use this when your agent needs to run Prisma commands, set up projects, or manage migrations.
prisma-client-api
Comprehensive Prisma Client API reference for v7.
Covers CRUD operations (findMany, create, update, delete), query options (select, include, omit, orderBy), filter operators, transactions ($transaction), raw queries ($queryRaw, $executeRaw), and client methods ($connect, $disconnect, $extends).
prisma-upgrade-v7
Step-by-step migration guide from Prisma v6 to v7.
Covers ESM module configuration, required driver adapters, the new prisma.config.ts file, manual environment variable loading, and removed features (middleware, metrics, deprecated CLI flags). Essential for upgrading existing projects.
prisma-mongodb-upgrade
Helps you move a MongoDB project from Prisma ORM 6 to Prisma ORM 8.
Covers the migration mechanics: schema-to-contract mapping, client API changes, the migration lifecycle, and cutover verification. Use this when your agent needs to make that move: it maps your schema and queries across and guides the cutover, following the MongoDB upgrade guide.
prisma-database-setup
Guides for configuring Prisma with different database providers.
Covers PostgreSQL, Prisma Postgres, MySQL/MariaDB, SQLite, MongoDB, SQL Server, and CockroachDB. Use this when setting up a new project or switching databases.
prisma-postgres
Prisma Postgres workflows across Console, CLI, REST API, and SDK.
Covers npx create-db, Console operations, programmatic provisioning via the REST API, and the @prisma/management-api-sdk. Use this when creating or managing Prisma Postgres databases.
prisma-postgres-setup
Gets a new Prisma Postgres database up and connected to your project.
Covers authenticating with a service token, listing regions, creating a project and database via the REST API, obtaining a connection string, and configuring prisma.config.ts, the schema, and the driver adapter. Use this when setting up a database or connecting an app to Prisma Postgres.
prisma-compute
Deploys and hosts your app on Prisma Compute.
Covers prisma.compute.ts and defineComputeConfig, the unified Prisma CLI's service, project, and git commands, auth and workspace selection, runtime host/port binding, and framework readiness for Next.js, Nuxt, Astro, Hono, Nest, TanStack Start, and more. Use this when deploying or hosting a Prisma app.
prisma-driver-adapter-implementation
Helps you build a SQL driver adapter for Prisma ORM 7.
Covers SqlDriverAdapter, Transaction, savepoint hooks, argument and result mapping, DriverAdapterError behavior, and shadow-database handling. Use this when building a new database driver adapter or debugging adapter-level transaction and error behavior.
Available skills for Prisma ORM 8
Prisma ORM ships one skill, prisma-8. It travels inside the @prisma/orm-postgres, @prisma/orm-sqlite, and @prisma/orm-mongo packages, so the copy in your project always describes the version you installed.
Projects scaffolded with create-prisma already have it: the scaffold runs prisma init for you. orm init does not install skills; its only skill work is deleting retired skill directories. To install the skill in an existing project, or to refresh it after adding an agent runtime, use the family-level CLI:
bunx --bun prisma@latest initThat sets up the skill for every agent runtime the installer supports (Claude Code, Cursor, Codex, Windsurf). prisma skills sync copies the skill out of the installed package into those directories, and every prisma command prints one line on stderr when the copies have drifted from the installed packages.
| Skill | What your agent uses it for |
|---|---|
prisma-8 | Everything Prisma ORM: contract authoring (PSL and TypeScript builders), picking the right API for a query (the ORM API, the SQL query builder, the MongoDB pipeline builder), migrations and reviews, setting up the client (db.ts, middleware, DATABASE_URL), build-tool integration, Supabase and RLS, reading PN-* structured errors, and upgrading an application or an extension package. Routes each task to a bundled reference file. |
Upgrading is a branch inside prisma-8, not a separate skill. The two flows live in its references/upgrade-app.md and references/upgrade-extension.md, and the per-transition instructions under prisma-8/upgrading/; the version you upgrade to carries the instructions for the transitions leading to it.
If you want the skill without installing the packages, npx skills add prisma/prisma/skills#v<your-version> --skill prisma-8 still reads the repository. That is a fallback: nothing keeps a copy installed that way up to date.
The Prisma ORM docs reference the prisma-8 skill in each page's "Prompt your coding agent" section, with prompts that map to the page you are reading.
Available skills for Prisma Composer
Prisma Composer ships one skill, prisma-composer-core-concepts. It travels inside the @prisma/composer package, so the copy in your project always describes the version you installed. After you install the package, copy the skill into the directories your agent reads:
bunx prisma skills syncnpx prisma@latest init runs the same sync and also adds a postinstall hook that repeats it after every install and upgrade. If the project has the Prisma ORM 7 CLI installed, write npx prisma@latest skills sync, because the version 7 CLI has no skills command.
If you want the skill without installing the package, npx skills add prisma/composer still reads the prisma/composer repository. That is a fallback: nothing keeps a copy installed that way up to date.
It covers the whole Composer story: the mental model (Modules, compute(), service.load()), RPC contracts, databases, the first-party Modules for scheduled jobs, object storage, and event streams, config params and secrets, testing, and deploying with stages. Install it before your agent writes Composer code so it works from the current authoring API instead of inventing one.
Useful commands
List available skills before installing:
bunx skills add prisma/skills --listList skills currently installed in your project:
bunx skills listExample prompts
Once skills are installed, your agent will use them automatically. Try prompts like:
- "Set up Prisma with PostgreSQL in this project"
- "Upgrade this project from Prisma 6 to 7"
- "Write a query to find all users with their posts"
- "Run migrations for production"
- "Create a new Prisma Postgres database"
Learn more
- Prisma Skills on skills.sh - browse available skills and install instructions
- GitHub repository - source code, contribution guidelines, and skill structure
- Agent Skills format - the open standard behind skills