list-npm-package-content

SKILL.md

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 debugging publish issues and validating package structure

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: