Home/后端开发/list-npm-package-content
L

list-npm-package-content

by @vercelv
4.9(34)

Before publishing an npm package, lists all files and directory structures within its tarball in detail, ensuring package content meets expectations and avoiding publishing errors.

npmNode.jsPackage ManagementJavaScript EcosystemCLI ToolsGitHub
Installation
npx skills add vercel/ai --skill list-npm-package-content
compare_arrows

Before / After Comparison

1
Before

When publishing an NPM package, it's unclear which files will ultimately be included. This can lead to the accidental release of sensitive information or unnecessary files, causing security risks or an excessively large package size.

After

Before publishing, all contents of the NPM package can be clearly listed, allowing for pre-publication inspection and adjustment. This ensures accurate content and avoids unnecessary risks.

description SKILL.md


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

forumUser Reviews (0)

Write a Review

Effect
Usability
Docs
Compatibility

No reviews yet

Statistics

Installs892
Rating4.9 / 5.0
Version
Updated2026年3月16日
Comparisons1

User Rating

4.9(34)
5
0%
4
0%
3
0%
2
0%
1
0%

Rate this Skill

0.0

Compatible Platforms

🔧Claude Code
🔧OpenClaw
🔧OpenCode
🔧Codex
🔧Gemini CLI
🔧GitHub Copilot
🔧Amp
🔧Kimi CLI

Timeline

Created2026年3月16日
Last Updated2026年3月16日