Record upgrade instructions
Lets an agent write upgrade-instruction fragments for Prisma 8 breaking changes in a PR.
- Repository
- prisma/orm
- Stars
- 47,663
- Licence
- Apache-2.0
- Files
- 1 file
What it does
This skill guides an AI agent working on a Prisma contributor PR that makes a breaking change to Prisma 8. Instead of editing shared migration guides, the agent writes small, independent upgrade-instruction fragments (markdown with YAML frontmatter, optional scripts) into a pending folder, which release tooling later combines into published guides. It also explains how to write precise detection patterns and when to declare no changes.
Great for
- Prisma maintainers and contributors submitting breaking-change PRs to the Prisma 8 codebase
- Reviewers checking that a PR's upgrade instructions are correctly scoped and tested
Skip it if
- Ordinary application developers who just want to upgrade their own Prisma project; the skill is for framework contributors editing the Prisma repository (the published upgrade skills are the consumer-facing side)
- Repositories unrelated to Prisma, since the referenced paths and lifecycle only exist inside the Prisma monorepo
Try asking
- “Record upgrade instructions for this PR”
- “My refactor made tests red in examples/ and I fixed them by updating example code; write the upgrade fragment”
- “Add an upgrade instruction fragment for the extension SPI change in packages/3-extensions/”
Install in 3 steps
- 1
Download the skill
The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.
record-upgrade-instructions.zip - 2
Add it to your agent
Claude Code (all projects)
mkdir -p ~/.claude/skills && unzip record-upgrade-instructions.zip -d ~/.claude/skills/Claude Code / Agent SDK (this project only)
mkdir -p .claude/skills && unzip record-upgrade-instructions.zip -d .claude/skills/Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.
- 3
Ask for the task
No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.
Get better results
- Only use this skill for PRs that change Prisma 8 consumer-facing behaviour; declare changes: [] for internal-only work.
- Test any colocated script in the integration test folder before submitting, and verify regex detection against near-miss false positives.
What's inside
- SKILL.md
Redistributed unmodified from prisma/orm under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.