# List Npm Package Content

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

Source: https://skillsagentes.com/skills/vercel/ai/list-npm-package-content
Repository: https://github.com/vercel/ai
Author: vercel
License: NOASSERTION
Updated: hace 6 meses
Context cost: 47 tok installed, 264 tok once triggered, 299 tok with every bundled file
Bundle: 2 files, 1 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add vercel/ai --skill list-npm-package-content --agent claude-code
```

## What it does

- Ejecuta bash scripts/list-package-files.sh para construir el paquete y crear un tarball de npm
- Lista los archivos exactos que se incluirían en el tarball publicado
- Limpia automáticamente los archivos temporales tras mostrar el contenido

## Use it when

- El usuario quiere ver qué archivos se incluyen en un bundle de npm
- Necesita verificar el contenido del paquete antes de publicarlo
- Está depurando problemas relacionados con npm publish

## What triggers it

- "¿Qué archivos incluye el tarball de este paquete de npm?"
- "Verifica el contenido del paquete antes de publicarlo en npm"
- "Ayúdame a depurar por qué faltan archivos al hacer npm publish"

## Before you install

- Debe ejecutarse desde el directorio del paquete (por ejemplo, packages/ai) usando el script scripts/list-package-files.sh.
- Needs on PATH: pnpm

## Files

- SKILL.md — 1 KB
- scripts/list-package-files.sh — 142 B

## SKILL.md

Reproduced verbatim from vercel/ai under NOASSERTION. This section is the upstream document and is in English.

# 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
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.

---

Skills Agentes — https://skillsagentes.com/skills/vercel/ai/list-npm-package-content