list-npm-package-content

List npm package tarball contents respecting package.json and ignore rules.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Hadimetlej/VERCEL-AI --skill list-npm-package-content-hadimetlej
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-npm-package-content
Source: https://github.com/Hadimetlej/VERCEL-AI/tree/main/skills/list-npm-package-content
Command: npx skills add https://github.com/Hadimetlej/VERCEL-AI --skill list-npm-package-content-hadimetlej

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pnpm, and includes scripts (resource) components.

What problem does it solve?

This skill lists the exact contents of an npm package tarball - the same files that would be uploaded to npm and downloaded by users.

Core Features & Use Cases

  • Tarball content inspection: lists files included in the npm package tarball, respecting package.json, .npmignore, and .gitignore rules.
  • Verification & debugging: helps confirm what will be published and diagnose missing or unwanted files before publishing.
  • Use Case: When preparing an npm publish, quickly review the tarball contents to ensure compliance with project policies.

Quick Start

From the package directory, run the script to build the package, create a tarball, and list its contents.

Frequently Asked Questions about list-npm-package-content

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list the exact files that will be included in my npm package tarball before publishing?

To list npm package tarball contents before publishing, run a script that builds the package, creates the tarball, and lists its files. This process respects package.json, .npmignore, and .gitignore rules to expose exact inclusion or exclusion results.

Why does my npm package tarball include unwanted files despite having a .gitignore file?

Your npm package tarball includes unwanted files because tarball composition is influenced by package.json, .npmignore, and .gitignore rules. Inspecting the generated tarball contents helps diagnose and verify which specific rules are correctly excluding files before publishing.

Can I use pnpm to verify which files are excluded from an npm package tarball?

Yes, you can use pnpm to verify excluded files from an npm package tarball. The verification process requires pnpm to run the scripts that build, pack, and list the tarball contents, ensuring .npmignore and .gitignore rules correctly exclude files before publishing.

What is the best way to audit npm package contents for compliance with project publishing policies?

The best way to audit npm package contents for publishing compliance is to generate and inspect the tarball contents. This auditing step exposes the exact files that will be uploaded to npm, allowing you to verify correct file inclusion and exclusion against project policies.

Do I need a package.json file to inspect what files will be published to npm?

Yes, you need a package.json file to inspect what files will be published to npm. The package.json file, along with .npmignore and .gitignore rules, directly influences the tarball composition and determines the exact file contents included in the final package.

When do I need to inspect npm tarball contents during the publishing workflow?

You need to inspect npm tarball contents during publish preparation, verification, and auditing. This inspection prevents publishing surprises by ensuring correct file inclusion or exclusion right before the package is uploaded to npm and downloaded by users.