Skip to main content
skill CX Codex

list-npm-package-content — Claude Code skill

The list-npm-package-content skill lists exactly which files will be included when you publish to npm. Check your bundle contents before publishing or verify that unwanted files didn't sneak in.

Apache-2.0 22 installs ★ 28,120 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vercel/ai --skill list-npm-package-content -a claude-code
Open on GitHub

What list-npm-package-content does

The skill runs scripts/list-package-files.sh from your package directory (such as packages/ai). It builds the package, creates a tarball, and prints its contents—the same files users will download.

Inclusion is controlled by the files field in package.json, .npmignore (or .gitignore if .npmignore doesn't exist). package.json, README, LICENSE, and CHANGELOG are always bundled. .git, node_modules, and .npmrc are always excluded.

Run it before npm publish to audit what goes out, or to debug why a file did or didn't make it into the package.

What it helps with

  • view which files will be included in an npm package
  • verify that sensitive files were excluded before publishing
  • debug why a file is or isn't in the bundle
  • confirm README and LICENSE are present in the tarball

Example prompts for the agent

  • Show me what files are in my npm package
  • List the contents of the tarball before I publish
  • What gets uploaded to npm when I publish this?

How to install list-npm-package-content

1Skills CLI (Vercel)

npx skills add vercel/ai --skill list-npm-package-content -a claude-code

2Manually: put the files in place

~/.claude/skills/list-npm-package-content/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/list-npm-package-content/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about list-npm-package-content

How do I install list-npm-package-content in Claude Code?

Run npx skills add vercel/ai --skill list-npm-package-content -a claude-code, then open ~/.claude/skills/list-npm-package-content/SKILL.md.

What does list-npm-package-content do?

It shows the exact list of files that will be bundled when you publish to npm. Use it to confirm the right files are included and to catch unwanted or sensitive files before they go live.

What controls which files go into the package?

The files field in package.json, plus .npmignore (or .gitignore as a fallback). Files like package.json, README, LICENSE, and CHANGELOG are always included; .git, node_modules, and .npmrc are always excluded.

Source text

SKILL.md · Apache-2.0
---
name: list-npm-package-content
description: 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.
metadata:
  internal: true
---

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

© vercel · Apache-2.0 · vercel/ai

Similar skills

All skills for DevOps and infrastructure →

From the same set4

Project sponsors

Companies that keep this analytics open