/npm

name: npm
description: Manage npm packages — install, publish, version bump, audit, and run scripts using the npm tool.

NPM Skill

Use the `npm` tool to manage Node.js packages and run npm workflows.

Common workflows

Install dependencies

npm tool: action=install
npm tool: action=install, args="express @types/express --save-dev"

Run scripts

npm tool: action=run, args="dev"
npm tool: action=test
npm tool: action=build

Publish a package

Always do a dry run first to verify what will be published:

npm tool: action=publish, dry_run=true

Then publish for real:

npm tool: action=publish
npm tool: action=publish, args="--tag beta"

Version bumps

Preview first, then apply:

npm tool: action=version, args="patch", dry_run=true
npm tool: action=version, args="minor"

Check for issues

npm tool: action=outdated
npm tool: action=audit
npm tool: action=audit, args="--fix"

Inspect packages

npm tool: action=info, args="react"
npm tool: action=list, args="--depth=0"

Guidelines

1. **Before publishing**, always read `package.json` to verify name, version, files, and registry config. 2. **Use `dry_run: true`** for publish, pack, and version to preview before committing. 3. **Check `npm outdated`** before updating to understand what will change. 4. **Run `npm audit`** after installing new dependencies. 5. When working in a monorepo, use the `path` parameter to target specific packages.