| name | publish |
| description | Guided npm publish workflow — version bump, quality gate, build, publish, tag |
| argument-hint | [version: "patch", "minor", "major", or explicit like "1.1.0"] |
Prepare and publish a new version: $ARGUMENTS
This skill guides through the full release process. It does NOT auto-publish — it pauses for user confirmation at key points.
Workflow
Step 1 — Determine Version
- Read current version from
package.json
- Calculate new version based on
$ARGUMENTS (default: patch)
- Show:
Current: X.Y.Z → New: A.B.C
Get user confirmation before proceeding.
Step 2 — Pre-flight Checks
Verify the codebase is ready:
git status — working tree should be clean (no uncommitted changes)git branch — should be on main branch- Check version consistency across
package.json, server.json, src/index.ts
npm run format:check — formatting is cleannpm run typecheck — no type errorsnpm run lint — no lint errorsnpm run test — all tests passnpm run build — build succeeds
If ANY check fails, stop and report. Do not continue with a broken build.
Step 3 — Bump Version
Update version in all 3 locations:
package.json → versionserver.json → version and packages[0].versionsrc/index.ts → server constructor version
Step 4 — Rebuild
npm run build
The dist/ directory must reflect the new version.
Step 5 — Review Changes
Show git diff so the user can verify:
- Only version numbers changed (plus rebuilt dist/)
- No accidental modifications
Get user confirmation before committing.
Step 6 — Commit & Tag
git add package.json server.json src/index.ts dist/
git commit -m "chore: Bump version to A.B.C"
git tag vA.B.C
Step 7 — Publish
Show the command but DO NOT run it automatically:
npm publish
git push origin main --tags
Tell the user to run these commands themselves.
Rules
- Never publish from a dirty working tree
- Never publish from a branch other than main (unless user explicitly says so)
- Never skip the quality gate
- Always pause for user confirmation before commit and publish
- The version must be consistent across all 3 files before and after the bump
