List Npm Package Content

by vercel5028fa46b4b4No licenseListed Oct 8, 2026Updated Oct 8, 2026

List the contents of an npm package tarball before publishing. Use when the user wants to see what files are included in an npm bundle, verify package contents, or debug npm publish issues.

Includes scriptsSoftware Development
AI-generated overview

Lists the files inside an npm package tarball before publishing, to verify bundle contents.

What it does
This skill inspects an npm package tarball and reports the exact files that would be uploaded to npm and downloaded by users. It ships a shell script that builds the package, creates a tarball, lists its contents, and cleans up automatically. It also explains which files are included based on the package.json files field, .npmignore, .gitignore, and npm's always-included and always-excluded defaults.
When to use it
Use it when someone wants to see what files are included in an npm bundle, verify package contents before publishing, or debug npm publish issues.
Requirements
Requires a shell environment with bash, npm, and Node.js tooling to build the package and create the tarball. It ships an executable script, scripts/list-package-files.sh, which is run from the package directory.

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
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.

Source and attribution

Source:vercel/aiinskills/list-npm-package-contentat commit5028fa4

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal