list-npm-package-content

List npm package tarball contents before publishing.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/junaid-ali-ruk/ai-chatbot --skill list-npm-package-content-junaid-ali-ruk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-npm-package-content
Source: https://github.com/junaid-ali-ruk/ai-chatbot/tree/main/.gemini/skills/vercel-ai-main-skills/list-npm-package-content
Command: npx skills add https://github.com/junaid-ali-ruk/ai-chatbot --skill list-npm-package-content-junaid-ali-ruk

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 prior to publishing, helping ensure only intended files are included and enabling quick verification during release.

Core Features & Use Cases

  • Enumerates package contents from the tarball created by npm pack to confirm what will be published
  • Verifies alignment between repository and published package to catch unintended files
  • Useful in CI to validate publish readiness and catch issues before release

Quick Start

Run from the package directory to build, pack, and list tarball contents to see exactly what will be published.

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 preview npm package contents before publishing?

To preview npm package contents before publishing, you can build and pack the project using the pnpm package manager, then run a script to enumerate the resulting tarball files. This verifies exactly what will be published before release.

Why does my npm publish include unintended files?

Your npm publish includes unintended files when repository contents are not properly validated against the final tarball. Listing the tarball contents prior to publishing helps catch these unintended files and ensures only intended files are included.

What's the best way to validate npm publish readiness in CI pipelines?

The best way to validate npm publish readiness in CI pipelines is to pack the project and list the tarball contents automatically. This pre-publish check catches package issues and verifies release integrity before deployment.

Do I need pnpm to list npm tarball contents?

Yes, you need the pnpm package manager installed to use this specific solution. It requires pnpm to build the project and execute the npm pack command that generates the tarball for content enumeration.

Can I debug npm publish issues by checking the tarball?

Yes, you can debug npm publish issues by checking the tarball. Enumerating the exact contents of the package tarball allows you to verify alignment between your repository and the published package to catch missing or unexpected files.

How does an npm pack tarball inspection work for local development?

An npm pack tarball inspection works for local development by running a script from your package directory that builds the project, packs it into a tarball, and lists the exact files included to confirm release integrity.