prisma-mongodb-upgrade Skill for Claude: Prisma and MongoDB Upgrades

prisma-mongodb-upgrade helps Claude decide whether a Prisma MongoDB project should stay on v6 or move to Prisma 8, and how to migrate.

Installs: 384.1K; on skills.sh
Stars: 77; on GitHub
Files: 5; besides SKILL.md
Updated: Oct 2026; last repo commit

prisma-mongodb-upgrade is Prisma's decision and migration guide for MongoDB projects on Prisma ORM v6. Per the skill, v7 never ships a MongoDB connector, so Claude must never tell you to upgrade to Prisma 7. The successor is Prisma 8, where MongoDB support is Early Access.

It triggers on phrases such as "upgrade prisma mongodb" or "prisma 7 mongodb", and when a project with provider = "mongodb" asks about upgrading. It has a decision table and five reference files. It tells Claude to check the installed Prisma 8 version before trusting any claim, because MongoDB support still changes between release candidates.

Good for

Developers on Prisma ORM v6 with a MongoDB database
Teams deciding whether to stay on v6 or try Prisma 8
Anyone who got the generic "upgrade to Prisma 7" advice for a MongoDB app

Install prisma-mongodb-upgrade

Claude Code

Copy this prompt.

Install the prisma-mongodb-upgrade skill in Claude Code. Run this command:

npx skills add https://github.com/prisma/skills --skill prisma-mongodb-upgrade

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Decision and migration guide for Prisma ORM MongoDB projects on v6, which have no upgrade path to v7. Use when a MongoDB project asks about upgrading Prisma, when "upgrade to prisma 7" comes up in a project with provider = "mongodb", or when evaluating a move to Prisma 8. Triggers on "upgrade prisma mongodb", "prisma 7 mongodb", "mongodb prisma migration", "prisma 8 mongodb".

Sections in SKILL.md

The version landscape
The decision, up front
Decision table
If staying on v6: hygiene (a deliberate stay, not neglect)
Reference files
Verified against
Hand-off rule

Key facts

Author: prisma
License: MIT
Installs on skills.sh: 384,072 as of 2026-11-02
GitHub stars: 77 for the whole prisma/skills repo
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass
What is inside: 6 files: SKILL.md and 5 reference files; no scripts
Needs: Nothing to run; for Prisma 8 the skill lists Node.js 22.18+, TypeScript 5.9+, MongoDB 8.0+ and mongodb@7
Last commit to the repo: 2026-10-30

What it includes

Migrate to Prisma 8, or stay on v6
Migrating is the encouraged path. Stay on v6 if you rely on multi-document transactions or cannot absorb breaking changes between release candidates.
Try: “Should my MongoDB project upgrade Prisma?”
Read · Decision table
No Prisma 7 for MongoDB; no switch to SQL by default
Claude must not suggest Prisma 7 for MongoDB, and must not treat a database change as part of the version question.
Read · Never-do rules
Full framing, blocker checks, stay hygiene
Includes pinning to the latest 6.x line and tracking advisories.
Read · references/decision-stay-or-migrate.md
v6 schema to Prisma 8 contract
Covers the mongodb provider, @db.ObjectId and composite types.
Read · references/schema-contract-mapping.md
v6 client calls to Prisma 8 equivalents
Includes raw escape hatches and transactions.
Read · references/client-api-mapping.md
db push to plan, migrate, verify, sign
Maps the v6 db push flow to Prisma 8's flow.
Read · references/migrations-mapping.md
Checks before you cut over
Same database, index parity and a staged round-trip.
Read · references/verify-cutover-checklist.md
After switching, use Prisma 8's own synced skill
Run prisma skills sync and follow the synced prisma-8 skill instead of this one.
Read · Hand-off rule

From the official docs

Permissions

Low risk

This skill is guidance, but the migration it describes edits your code and touches how your app reaches MongoDB. Use a branch, rehearse on a copy of your data, and re-check the installed Prisma 8 version first.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

A migration changes real code and config
SKILL.md covers moving a MongoDB project from Prisma 6 to Prisma 8, where MongoDB support is Early Access. Work on a branch and review the diff.
It tells you to rehearse on a copy
The decision table and verify-cutover-checklist reference call for rehearsing on a copy of your data before cutover.

Technical details

Scopes	Reads your Prisma schema and code Can edit code and schema when you ask for the migration Suggests npm ls @prisma/orm-mongo and prisma skills sync

Questions

What does prisma-mongodb-upgrade do?

It guides Claude through Prisma and MongoDB upgrades. It frames the choice between staying on Prisma ORM v6 and migrating to Prisma 8, and carries the mapping notes for the migration.

How do I install prisma-mongodb-upgrade?

Use the install box at the top of this page. Prisma's repo also documents installing all its skills, or a single one with --skill, through the skills CLI.

Can I upgrade my MongoDB project to Prisma 7?

No. The skill says v7 never ships a MongoDB connector, and that v6 is the last classic-ORM major for MongoDB. The successor path is Prisma 8, where MongoDB support is Early Access.

Should I migrate to Prisma 8 now?

The skill calls migrating the encouraged path, with exceptions. Check multi-document transactions first: it says Prisma 8 has no MongoDB transaction method yet. It also warns that behavior can change between release candidates.

Is the Prisma 8 information current?

It was checked against a specific Prisma guide and commit, per SKILL.md, and the skill says to check your installed version first (npm ls @prisma/orm-mongo). Treat it as a starting point.

Does it change my project?

The skill is a guide and bundles no scripts, but Claude can edit your code and schema when you ask for the migration. Use a branch and rehearse on a copy of your data.

Is prisma-mongodb-upgrade safe?

It bundles no scripts. On skills.sh the audits read Gen Agent Trust Hub pass, Socket pass and Snyk pass. Any migration it helps with changes real code, so review the diff.

Information

updated Nov 2, 2026

Repository: prisma/skills
Folder: prisma-mongodb-upgrade

prisma/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 2

prisma-mongodb-upgrade SKILL.md · github.com
Prisma ORM 6 to 8 (MongoDB) guide · prisma.io