list-npm-package-content作成者: vercel

Inspect npm package tarball contents before publishing to verify what files will be distributed. Lists exact files that would be uploaded to npm, helping catch missing or unwanted inclusions before publish Respects files field in package.json, .npmignore , and .gitignore rules to show the actual bundle contents Automatically builds the package, creates a tarball, displays contents, and cleans up in a single command Run from the package directory with a simple bash script; useful for...

npx skills add https://github.com/vercel/ai --skill list-npm-package-content

List npm Package Content

This skill lists the exact contents of an npm package tarball - the same files that would be uploaded to npm and downloaded by users.

Usage

Run the script from the package directory (e.g., packages/ai):

bash scripts/list-package-files.sh

The script will build the package, create a tarball, list its contents, and clean up automatically.

Understanding Package Contents

The files included are determined by:

  1. files field in package.json - explicit allowlist of files/directories
  2. .npmignore - files to exclude (if present)
  3. .gitignore - used if no .npmignore exists
  4. Always included: package.json, README, LICENSE, CHANGELOG
  5. Always excluded: .git, node_modules, .npmrc, etc.