prisma-upgrade-v7

The prisma-upgrade-v7 skill provides a comprehensive migration guide for developers transitioning from Prisma ORM version 6 to version 7. It addresses the challenges and breaking changes introduced in the new release, ensuring that projects are updated correctly and efficiently. By following this skill, developers can resolve issues related to version upgrades, including errors stemming from the updated prisma-client generator, required driver adapters, and new configuration requirements in prisma.config.ts. This skill is especially useful for maintaining project stability while leveraging the latest Prisma features and standards.

Key features of prisma-upgrade-v7 include a detailed overview of priority rule categories, such as schema migration, database connectivity, module system adjustments, configuration, and environment variable management. It also highlights removed features and provides guidance for users of the Accelerate migration tool. The skill outlines explicit upgrade steps, including package updates, module format selection (ESM or CommonJS), schema generator adjustments, client instantiation changes, driver adapter installation, environment variable handling, and replacement of deprecated patterns like Prisma.validator. Additionally, it includes quick reference commands for common upgrade tasks and a summary of breaking changes, offering a clear roadmap for a smooth transition.

This skill is targeted at developers, technical leads, and teams managing projects that rely on Prisma ORM. It is particularly relevant for projects using SQL providers, TypeScript 5.4.0 or later, and Node.js 20.19.0+. It guides users in updating their Prisma setup while minimizing migration issues, ensuring that both new and legacy projects can benefit from Prisma 7's features. Use cases include upgrading existing Prisma projects, configuring new generator and adapter setups, resolving import or environment loading errors, and preparing codebases for modern ESM-first practices.