prisma-upgrade-v7

Prisma upgrade to v7

prisma-upgrade-v7 is Prisma's agent skill for upgrading a project from Prisma ORM 6 to 7, covering every breaking change: the new generator, driver adapters, prisma.config.ts, ESM and removed features.

Checked by CookiesForAI on : license and last change of the skill re-read from GitHub; install tested on in Claude Code 2.1.286 and Codex CLI 0.160.0.

Written by

Install Prisma upgrade to v7

Install this skill with the skills CLI

Terminal
npx skills add prisma/skills --skill prisma-upgrade-v7

Install tested

On , we ran npx skills add prisma/skills --skill prisma-upgrade-v7 -a claude-code codex --copy -y (skills CLI 1.7.1) in an empty project. It copied 8 files into each agent's skill folder (.claude/skills/prisma-upgrade-v7 and .agents/skills/prisma-upgrade-v7), and Claude Code 2.1.286 and Codex CLI 0.160.0 then listed prisma-upgrade-v7 as an available skill.

Or paste this into your coding agent: Install the agent skill prisma-upgrade-v7 from github.com/prisma/skills. Checked by CookiesForAI on : license and last change of the skill re-read from GitHub; install tested on in Claude Code 2.1.286 and Codex CLI 0.160.0. A skill can include scripts that run on your computer, so read its source first.

What Prisma upgrade to v7 does

prisma-upgrade-v7 is an agent skill from Prisma that takes an existing project from Prisma ORM 6 to Prisma ORM 7. It ranks the breaking changes by impact: schema and generator changes, driver adapters and the module system are critical, while config and environment loading, removed features and Accelerate are high. Each area has its own reference file that the agent reads when it reaches that step.

The prisma-upgrade-v7 skill lays the upgrade out in ten steps. The agent updates the packages, chooses ESM or keeps CommonJS with moduleFormat set to cjs, updates tsconfig, switches the generator to prisma-client with an explicit output path, creates prisma.config.ts, installs a driver adapter such as @prisma/adapter-pg, and loads environment variables itself with dotenv. It then fixes imports and client setup and runs prisma generate.

The skill also replaces Prisma.validator with TypeScript's satisfies, moves $use middleware to Client Extensions, and notes that metrics were removed. It stops MongoDB projects early: Prisma 7 has no MongoDB connector, so those projects should stay on version 6 or move to Prisma 8 with the separate prisma-mongodb-upgrade skill.

When to use Prisma upgrade to v7

  • You want to upgrade a project from Prisma 6 to Prisma 7.
  • After upgrading you get an error saying a driver adapter is required.
  • Your imports from @prisma/client broke after switching to the prisma-client generator.
  • You use Prisma middleware or Accelerate and need to know what changes in 7.

When to pick something else

  • MongoDB projects: use prisma-mongodb-upgrade from the same repository.
  • New projects: Prisma's README says new setups now default to Prisma ORM 8, set up with its prisma-orm-setup skill.

What Prisma upgrade to v7 needs

  • Node.js 20.19.0 or newer and TypeScript 5.4.0 or newer
  • A SQL database such as PostgreSQL, MySQL or SQLite

Which agents Prisma upgrade to v7 works in

Prisma documents Prisma upgrade to v7 for Any agent that reads SKILL.md files, through the skills CLI. The open skills CLI also installs it into 78 agents, including Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode (we listed it with the CLI on ). See where each agent looks for skills.

Prisma upgrade to v7 license

Prisma upgrade to v7 is published under MIT.

Lists that include prisma-upgrade-v7