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
npx skills add vercel/ai --skill list-npm-package-content -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/list-npm-package-content/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/list-npm-package-content/
1Skills CLI (Vercel)
npx skills add vercel/ai --skill list-npm-package-content -a codex2Manually: put the files in place
.agents/skills/list-npm-package-content/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add vercel/ai --skill list-npm-package-content -a cursor2Manually: put the files in place
.cursor/skills/list-npm-package-content/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install vercel/ai skills/list-npm-package-content2Manually: put the files in place
.github/skills/list-npm-package-content/SKILL.md1Skills CLI (Vercel)
npx skills add vercel/ai --skill list-npm-package-content -a gemini-cli2Platform CLI
gemini skills install https://github.com/vercel/ai --path skills/list-npm-package-contentManually: put the files in place
.devin/skills/list-npm-package-content/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add vercel/ai --skill list-npm-package-content -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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