# 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 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](https://github.com/prisma/skills) | `npx skills add prisma/skills` | | [Prisma ORM 8](https://www.prisma.io/docs/orm) | ships inside the `@prisma/orm-*` packages | `npx prisma@latest init` | | [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 ORM 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 ORM 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 ORM 6 to [Prisma ORM 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 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 [#available-skills-for-prisma-8] [Prisma ORM](https://www.prisma.io/docs/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`](https://www.prisma.io/docs/cli/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: #### bun ```bash bunx --bun prisma@latest init ``` #### pnpm ```bash pnpm dlx prisma@latest init ``` #### yarn ```bash yarn dlx prisma@latest init ``` #### npm ```bash npx prisma@latest init ``` That sets up the skill for every agent runtime the installer supports (Claude Code, Cursor, Codex, Windsurf). [`prisma skills sync`](https://www.prisma.io/docs/cli/skills) 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 --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 [#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