# Agent Skills (/docs/ai/tools/skills)

> For the complete Prisma documentation index, see [llms.txt](https://www.prisma.io/docs/llms.txt). A markdown version of any docs page is available by appending `.md` to its URL.

Give your AI coding agent up-to-date Prisma knowledge with installable skills

Location: AI > AI Tools > Agent 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](https://agentskills.io/) format. Once installed, your agent uses them whenever it detects a relevant task, no prompting required.

Prisma ships skills from three repositories, matched to what you are building:

| You are working with                           | Skills repository                                                 | Install command                       |
| ---------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------- |
| Prisma ORM v7, Prisma Postgres, Prisma Compute | [prisma/skills](https://github.com/prisma/skills)                 | `npx skills add prisma/skills`        |
| [Prisma 8](https://www.prisma.io/docs/orm)                               | [prisma/prisma](https://github.com/prisma/orm) (`skills/`)        | `npx skills add prisma/prisma/skills` |
| [Prisma Composer](https://www.prisma.io/docs/composer)                   | [prisma/composer](https://github.com/prisma/composer) (`skills/`) | `npx skills add prisma/composer`      |

## Install [#install]

Add all skills from the main registry to your project:

  

#### bun

```bash
bunx skills add prisma/skills
```

#### pnpm

```bash
pnpm dlx skills add prisma/skills
```

#### yarn

```bash
yarn dlx skills add prisma/skills
```

#### npm

```bash
npx skills add prisma/skills
```

Or install only the ones you need:

  

#### bun

```bash
bunx skills add prisma/skills --skill prisma-client-api
```

#### pnpm

```bash
pnpm dlx skills add prisma/skills --skill prisma-client-api
```

#### yarn

```bash
yarn dlx skills add prisma/skills --skill prisma-client-api
```

#### npm

```bash
npx skills add prisma/skills --skill prisma-client-api
```

The Prisma 8 CLI's [`skills` commands](https://www.prisma.io/docs/cli/skills) do not install from this registry. They sync the skills that ship inside the Prisma 8 packages a project installs, so use `npx skills add prisma/skills` directly for the v7 skills above.

> [!NOTE]
> Skills are compatible with any agent that supports the [Agent Skills](https://agentskills.io/) format, including Claude Code, Cursor, Codex, Windsurf, and others.

## Available skills [#available-skills]

### `prisma-cli` [#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` [#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` [#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` [#prisma-mongodb-upgrade]

Helps you move a MongoDB project from Prisma v6 to [Prisma 8](https://www.prisma.io/docs/orm).

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](https://www.prisma.io/docs/guides/upgrade-prisma-orm/mongodb).

### `prisma-database-setup` [#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]

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` [#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` [#prisma-compute]

Deploys and hosts your app on [Prisma Compute](https://www.prisma.io/docs/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` [#prisma-driver-adapter-implementation]

Helps you build a SQL driver adapter for Prisma v7.

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 8 [#available-skills-for-prisma-8]

[Prisma 8](https://www.prisma.io/docs/orm) ships its own skills from the [prisma/prisma](https://github.com/prisma/orm) repository, versioned with the product. Projects scaffolded with `create-prisma` or [`orm init`](https://www.prisma.io/docs/cli/orm-init) install them automatically for every agent runtime the installer supports (Claude Code, Cursor, Codex, Windsurf); skip that step with `orm init --skip-skills`. Add them to an existing project with:

  

#### bun

```bash
bunx skills add prisma/prisma/skills
```

#### pnpm

```bash
pnpm dlx skills add prisma/prisma/skills
```

#### yarn

```bash
yarn dlx skills add prisma/prisma/skills
```

#### npm

```bash
npx skills add prisma/prisma/skills
```

| Skill                        | What your agent uses it for                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prisma-8`                   | Everything Prisma 8: contract authoring (PSL and TypeScript builders), queries in the right lane (the ORM API, the SQL query builder, the MongoDB pipeline builder), migrations and reviews, runtime wiring (`db.ts`, middleware, `DATABASE_URL`), build-tool integration, Supabase and RLS, and reading `PN-*` structured errors. Routes each task to a bundled reference file. |
| `prisma-next-upgrade`        | Move a project between Prisma 8 releases                                                                                                                                                                                                                                                                                                                                         |
| `prisma-8-extension-upgrade` | Upgrade extension packs alongside the core                                                                                                                                                                                                                                                                                                                                       |

The `prisma-8` usage skill describes the exact CLI and runtime surface of one release, so pin it to your installed version when adding it by hand: `npx skills add prisma/prisma/skills#v<your-version> --skill prisma-8`. The two upgrade skills are intentionally unpinned; the latest revision covers every prior transition. `orm init` applies this pinning for you.

The Prisma 8 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 [#available-skills-for-prisma-composer]

[Prisma Composer](https://www.prisma.io/docs/composer) ships one skill, `prisma-composer`, from the [prisma/composer](https://github.com/prisma/composer) repository:

  

#### bun

```bash
bunx skills add prisma/composer
```

#### pnpm

```bash
pnpm dlx skills add prisma/composer
```

#### yarn

```bash
yarn dlx skills add prisma/composer
```

#### npm

```bash
npx skills add prisma/composer
```

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 [#useful-commands]

List available skills before installing:

  

#### bun

```bash
bunx skills add prisma/skills --list
```

#### pnpm

```bash
pnpm dlx skills add prisma/skills --list
```

#### yarn

```bash
yarn dlx skills add prisma/skills --list
```

#### npm

```bash
npx skills add prisma/skills --list
```

List skills currently installed in your project:

  

#### bun

```bash
bunx skills list
```

#### pnpm

```bash
pnpm dlx skills list
```

#### yarn

```bash
yarn dlx skills list
```

#### npm

```bash
npx skills list
```

## Example prompts [#example-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 [#learn-more]

* [Prisma Skills on skills.sh](https://skills.sh/prisma/skills) - browse available skills and install instructions
* [GitHub repository](https://github.com/prisma/skills) - source code, contribution guidelines, and skill structure
* [Agent Skills format](https://agentskills.io/) - the open standard behind skills

## Related pages

- [`ChatGPT`](https://www.prisma.io/docs/ai/tools/chatgpt): Learn how to add the Prisma MCP server to ChatGPT to manage your Prisma Postgres databases
- [`Codex`](https://www.prisma.io/docs/ai/tools/codex): Learn how to install the Prisma Codex plugin and use Prisma MCP from Codex
- [`Cursor`](https://www.prisma.io/docs/ai/tools/cursor): Learn tips and best practices for using Prisma ORM with the Cursor AI code editor
- [`GitHub Copilot`](https://www.prisma.io/docs/ai/tools/github-copilot): Learn about the features available with GitHub Copilot and Prisma ORM, plus best practices and tips
- [`MCP server`](https://www.prisma.io/docs/ai/tools/mcp-server): Manage Prisma Postgres databases using LLMs with the Prisma Model-Context-Protocol (MCP) Server