How do I verify package contents before publishing?

Run the script from the package directory. It builds the package, creates the tarball, and lists the files inside, so you can check exactly what would be uploaded to npm.

How do I debug npm publish issues?

Run the script to see the tarball contents. Compare the listed files with what you expect, then adjust the files field, .npmignore, or .gitignore rules.

Does it clean up after listing?

Yes. The script builds the package, creates a tarball, lists its contents, and cleans up automatically.

List npm Package Content

SkillFiles & storage

This skill lists the contents of an npm package tarball before publishing. It builds the package, creates the tarball, and shows the files inside, then cleans up. Use it to see what files are included in an npm bundle, verify package contents, or debug npm publish issues.

Connect your AI Use it in a pipeline

Then ask your AI: use the List npm Package Content skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.

No other account needed.

Have the package directory ready, for example packages/ai.

What your AI can do with it

Build the package and create its npm tarball
List the files inside the tarball
Show what users would download from npm
Reflect files field, .npmignore, and .gitignore rules
Clean up the tarball after listing

Getting started

Have the package directory ready, for example packages/ai.
Run the script from that directory: bash scripts/list-package-files.sh.
Read the listed files to see what the tarball includes.
The script builds the package, creates the tarball, lists its contents, and cleans up automatically.

What this skill tells your AI

The instructions your AI receives, as published by vercel/ai in skills/list-npm-package-content/SKILL.md and read by Ahel’s review.

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:

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

Signals

GitHub stars: 27k
Forks: 5k
Last commit: Oct 2026

Others that do the same job

list-npm-package-content
Skill · akarachen

Questions

What files are included in an npm bundle?: The files field in package.json is an explicit allowlist. .npmignore excludes files if present; otherwise .gitignore is used. package.json, README, LICENSE, and CHANGELOG are always included. .git, node_modules, .npmrc, and similar are always excluded.
How do I verify package contents before publishing?: Run the script from the package directory. It builds the package, creates the tarball, and lists the files inside, so you can check exactly what would be uploaded to npm.
How do I debug npm publish issues?: Run the script to see the tarball contents. Compare the listed files with what you expect, then adjust the files field, .npmignore, or .gitignore rules.
Does it clean up after listing?: Yes. The script builds the package, creates a tarball, lists its contents, and cleans up automatically.

Advanced

Item type: skill
Key: list-npm-package-content-vercel
Source: github.com/vercel/ai

github.com/vercel/ai