publish-npm-version

publish-npm-version is a skill for Claude Code, Codex from prisma/orm. It costs 159 tokens per session (2,278 once invoked), scanned A, original, Apache-2.0.

A release workflow for Prisma 8 that updates the package version across a workspace and opens a pull request. A workspace is a repository containing multiple related packages.

In plain words
What is it for?
It helps Prisma 8 maintainers prepare the next release candidate, update package versions, open the release pull request, and drive its release notes.
Why use it?
It keeps all packages on the same release version and makes the version change reviewable before merging triggers publication to npm, the JavaScript package registry.

Skill for Claude CodeCodex ✓ vendor

Written for no agent in particular: nothing here depends on one.

Needs its repository: it reads a path above its own folder, which exists only inside the repository. The line is git worktree add -b "release/$NEXT" "../release-$NEXT" origin/main.

Good fit It helps Prisma 8 maintainers prepare the next release candidate, update package versions, open the release pull request, and drive its release notes.

Compare 6 skills from other repositories ↓
About the project

Prisma ORM is a Node.js and TypeScript database toolkit that lets applications work with databases through a programming interface instead of writing every query directly in SQL. Developers use it with databases including PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, MongoDB, and CockroachDB. The catalogue add-ons provide agent rules, skills, hooks, agents, and other workflows for using Prisma.

prisma/orm · 47,608 stars · on GitHub · prisma.io

Install

Getting it into your agent

It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.

Clone the repo
git clone --depth 1 https://github.com/prisma/orm
agentmods
npx agentmods add skills/prisma/orm/publish-npm-version

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for publish-npm-version

README.md
[![agentmods](https://agentmods.dev/badge/skills/prisma/orm/publish-npm-version.svg)](https://agentmods.dev/skills/prisma/orm/publish-npm-version)
Your own site
<a href="https://agentmods.dev/skills/prisma/orm/publish-npm-version"><img src="https://agentmods.dev/badge/skills/prisma/orm/publish-npm-version.svg" alt="Measured on agentmods" height="20"></a>
Per session 159 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,278 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Snyk pass 7 Sept 2026
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00159 $0.02278
Opus 5 $0.00079 $0.01139
Sonnet 5 $0.00032 $0.00456
Haiku 4.5 $0.00016 $0.00228

Measured 4d ago against content hash 95f688c2838e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

publish-npm-version scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills-contrib/publish-npm-version/SKILL.md · 123 lines

How it starts

The opening of the file, as written. The whole thing — 123 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Publish next npm version

Audience

Maintainers of Prisma 8 who have permission to push branches and open PRs in the repository. The skill is invoked locally by the maintainer; it does not run as a GitHub Action. Running locally is what makes the resulting PR trigger CI normally — PRs opened by a workflow's GITHUB_TOKEN do not, which defeats the point of cutting a reviewable release.

Background reading

Read docs/oss/versioning.md before running this skill. It covers:

  • The source-of-truth model (root package.json version).
  • The lockstep guarantee (every workspace package matches the root).
  • The v8 RC line (8.0.0-rc.N, latest frozen until 8.0.0 final).
  • The dist-tag convention (latest / dev / beta).
  • The full release procedure (this skill covers steps 1-2 of 3; merging the PR is the publish trigger — there is no separate dispatch step).
  • The emergency-patch path (this skill does not handle patches).

This SKILL.md covers steps 1-2 — opening the bump PR and driving the release notes. Merging (step 3) stays the human gate.

Pre-flight

The skill does not require the maintainer to be on main or to have a clean working tree — it does all the work in a fresh worktree off origin/main, so the maintainer's current worktree (typically a feature branch in worktrees/<feature>/) is left undisturbed.

Before invoking this skill, confirm:

  1. The maintainer can fetch from origin (git fetch origin main succeeds).
  2. You are ready to draft the release notes for this bump. The draft-release-notes skill (invoked in step 7 below) enumerates the merged PRs since the previous stable tag and surfaces the release-notes-worthy changes — including any breaking changes — so this no longer rests on the maintainer's unaided recollection. If you already know of an in-flight breaking change that must be called out, note it so the authoring step gives it prominence.

If either precondition is unmet, stop and surface the issue. Do not try to auto-resolve.

Read the full file on GitHub · 123 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 123 lines · 159 tokens per session scan A 95f688c2838e

Subscribe to this mod's changes

publish-npm-version is a skill published in the GitHub repository prisma/orm (47,608 stars, last pushed 5d ago), licensed Apache-2.0. It adds 159 tokens to every session and 2,278 once invoked, about $0.0008 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

publish-npm-version

Cuts the next minor release of Prisma Next: bumps the root package.json version, propagates it to every workspace package, and opens a PR titled "chore(release): bump to ". When the maintainer merges the PR, the Publish to npm workflow runs automatically and ships the new version to npm under dist-tag latest, plus a…

prisma/prisma-next · 117 tokens

draft-release-notes

Author the committed release-notes file for a stable Prisma Next release by enumerating the merged PRs since the previous stable v tag, resolving opaque TML-NNNN: titles via Linear context (never copied verbatim), triaging public-worthiness, and writing categorized notes — breaking changes first — into docs/releases/v…

prisma/prisma-next · 154 tokens

pr-snapshot-release

Guide a Mastra maintainer through publishing an npm snapshot from a pull request or a specified repository branch. Use when asked to release, publish, or create a PR snapshot, branch snapshot, canary package build, or branch-specific npm tag. Performs source and branch preflight checks, requires confirmation before…

mastra-ai/mastra · 88 tokens

publish-release

Cut and publish a versioned release of @loopdive/js2 + the js2wasm proxy — bump both manifests in lockstep, land a reviewed release PR, then push the vX.Y.Z tag that triggers npm/JSR publish. Use this whenever the user wants to release, publish, ship, cut, or tag a version, bump the version number, push a release tag…

loopdive/js2 · 183 tokens

multipublish

Publish monorepo packages simultaneously to npm and JSR via a platforms config array. Integrates with changesets via stdin pipe or --useChangesetStatus flag. Use experimentalGenerateJSR to skip maintaining a jsr.json. Supports pnpm, bun, npm, yarn (jsr and npm); deno (jsr only). Config via cosmiconfig or package.json…

stephansama/packages · 83 tokens

create-pr

Creates a GitHub PR with a Linear-ticket-prefixed title and a decision-led, narrative description for prisma-next. Use when the user wants to create a pull request, open a PR, or submit changes for review.

prisma/prisma-next · 47 tokens