list-npm-package-content

por vercel

Inspeciona o conteúdo do tarball do pacote npm antes de publicar para verificar quais arquivos serão distribuídos. Lista os arquivos exatos que seriam enviados para o npm, ajudando a identificar inclusões ausentes ou indesejadas antes da publicação. Respeita o campo files no package.json, .npmignore e regras do .gitignore para mostrar o conteúdo real do pacote. Constrói automaticamente o pacote, cria um tarball, exibe o conteúdo e faz a limpeza em um único comando. Execute a partir do diretório do pacote com um script bash simples; útil para...

npx skills add https://github.com/vercel/ai --skill list-npm-package-content

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.