release

Release vercel-plugin — run gates, bump version, generate artifacts, commit, and push. Use when asked to "release", "ship", "bump and push", or "cut a release".

npx skills add https://github.com/vercel/vercel-plugin --skill release

Release

End-to-end release workflow for vercel-plugin.

Workflow

1. Pre-flight checks

Run all gates in parallel:

bun run typecheck          # tsc --noEmit on hooks/src
bun test                   # all test files
bun run validate           # skill frontmatter + manifest integrity

Stop if any gate fails. Fix issues before proceeding.

2. Determine version bump

Read the current version from .plugin/plugin.json. Ask the user which semver component to bump if not specified:

BumpWhen
patchBug fixes, test/fixture updates, docs
minorNew skills, new hooks, new features
majorBreaking changes to hook API or skill map

Default to patch if the user says "release" without specifying.

3. Bump version

Update the version field in .plugin/plugin.json. This is the only version source of truth.

4. Rebuild generated artifacts

bun run build              # hooks (tsup) + manifest

This compiles hooks/src/*.mtshooks/*.mjs and regenerates generated/skill-manifest.json.

5. Stage, commit, and push

git add -A
git commit -m "<summary>; bump to <new-version>"
git push

Commit message style: match existing convention — descriptive summary followed by ; bump to X.Y.Z (see git log for examples).

The pre-commit hook will re-run typecheck and recompile hooks automatically. If it fails, fix the issue and create a new commit (never amend).

Version source of truth

.plugin/plugin.json — the version field. There is no package.json version to sync.

Checklist (copy into your reasoning)

  • typecheck passes
  • tests pass
  • validate passes
  • .plugin/plugin.json version bumped
  • bun run build succeeded
  • commit includes all changes
  • pushed to main

More skills from vercel

emil-design-eng
vercel
This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.
official
vercel-react-best-practices
vercel
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js…
official
vercel-react-best-practices
vercel
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js…
official
write-guide
vercel
Produce a technical guide that teaches a real-world use case through progressive examples. Concepts are introduced only when the reader needs them.
official
deepsec
vercel
Run DeepSec against a Vercel project checkout from dev3000. Use for one-click DeepSec setup, project context bootstrapping, bounded first-pass processing, and…
official
backport-pr
vercel
Backport a merged Next.js pull request from canary to a previous release branch such as next-16-2. Use when the user asks to backport, cherry-pick, or open a…
official
frontend-design
vercel
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts,…
official
vercel-react-best-practices
vercel
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js…
official