list-npm-package-content

✓ Official★ 25,366

by vercel · part of vercel/ai

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.

🔥🔥🔥✓ VerifiedFreeQuick setup

#automation #git

🧰 Not standalone. This skill ships with vercel/ai and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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.

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.

Copy & paste — that's it

npx skills add vercel/ai --skill "list-npm-package-content" --full-depth

Run this in your project — your agent picks the skill up automatically.

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.