vercel avatar

List Npm Package Content

vercel/aiOfficial

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

Installs 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:

  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.

Sponsors

Details

Repository
github.com/vercel/ai
Categories
Release Management, Debugging, Cloud & Infrastructure
First seen
Apr 16, 2026

More from vercel/ai

All 8
1github avataraws-cdk-python-setupgithub/awesome-copilotSetup and initialization guide for developing AWS CDK (Cloud Development Kit) applications in Python. This skill enables users to configure environment prerequi1.7Kskills.sh installs
2nvidia avatartao-run-inference-servicenvidia/skillsStart, query, and stop a network-specific TAO inference microservice ({network_arch}-inference-microservice) by delegating container execution to the appropriat1.6Kskills.sh installs
3refoundai avatarscoping-cuttingrefoundai/lenny-skillsHelp users scope projects and cut features effectively. Use when someone is defining an MVP, dealing with scope creep, trying to ship faster, or needs to make t1.6Kskills.sh installs
4nexscope-ai avataretsy-seonexscope-ai/ecommerce-skillsEtsy SEO analyzer and optimizer. Improve search visibility with title optimization, tag analysis, description scoring, and keyword research. Includes SEO scorin1.5Kskills.sh installs
5qdrant avatarqdrant-deployment-optionsqdrant/skillsGuides Qdrant deployment selection. Use when someone asks 'how to deploy Qdrant', 'Docker vs Cloud', 'local mode', 'embedded Qdrant', 'Qdrant EDGE', 'which depl1.5Kskills.sh installs
6alirezarezvani avatarpostmortemalirezarezvani/claude-skills/em:postmortem — Honest analysis of what went wrong. Use after a failed launch, missed quarter, or bad hire to run a blameless 5-Whys retrospective with a chang1.5Kskills.sh installs