
List Npm Package Content
Before you publish to npm, you want to know exactly what files you're shipping. This skill runs a quick tarball inspection to show you the actual contents that would be distributed, which is surprisingly different from what's in your repo if you've got npmignore rules or a files field in package.json. It's the "measure twice, cut once" check for package authors. Saves you from accidentally publishing source maps, test fixtures, or private config files to the registry, or worse, discovering you forgot to include the dist folder. Run it from your package directory and it handles the build, tarball creation, listing, and cleanup automatically.
- skills.sh installs
- 1.7K
- GitHub stars
- 27.8K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add vercel/ai --skill list-npm-package-content --agent claude-codeInstalls into .claude/skills of the current project.
Files
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:
filesfield inpackage.json- explicit allowlist of files/directories.npmignore- files to exclude (if present).gitignore- used if no.npmignoreexists- Always included:
package.json,README,LICENSE,CHANGELOG - Always excluded:
.git,node_modules,.npmrc, etc.
Sponsors
Details
- Repository
- github.com/vercel/ai
- Categories
- Release Management, Debugging, Cloud & Infrastructure
- First seen
- Apr 16, 2026