dbt-tools-web-pack-npx-smoke

Packs the @dbt-tools/web package and smoke-tests its CLI via npx.

Updated Dec 29, 2025
One-click install
npx skills add https://github.com/yu-iskw/dbt-artifacts-parser-ts --skill dbt-tools-web-pack-npx-smoke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dbt-tools-web-pack-npx-smoke
Source: https://github.com/yu-iskw/dbt-artifacts-parser-ts/tree/main/.claude/skills/dbt-tools-web-pack-npx-smoke
Command: npx skills add https://github.com/yu-iskw/dbt-artifacts-parser-ts --skill dbt-tools-web-pack-npx-smoke

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Packs the @dbt-tools/web package into a tarball and smoke-tests the published dbt-tools-web CLI via npx without publishing to npm, enabling fast verification of packaging and distribution quality.

Core Features & Use Cases

  • Creates a tarball for the web package and validates the bin/dist-serve layout.
  • Smoke-tests the CLI via npx against the packaged artifact to catch packaging or dependency rewrite issues before publish.
  • Useful for CI parity, pre-release checks, and debugging pack/npx failures in the web package.

Quick Start

From the repo root, run the Verdaccio-based smoke workflow to build, publish, pack, and smoke-test the web package.

Frequently Asked Questions about dbt-tools-web-pack-npx-smoke

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

FAQPage Schema
How do I smoke-test an npm package tarball with npx without publishing to npm?

To smoke-test an npm package tarball with npx without publishing, pack the package into a tarball and execute the CLI via npx against the artifact. This validates binary exposure and dependency rewrites before actual npm distribution.

Why does my web package CLI fail when running via npx after packing?

A web package CLI might fail during npx execution after packing due to incorrect bin or dist-serve layouts. Running a Verdaccio-based smoke test validates the tarball packaging and catches dependency rewrite issues before release.

What is a Verdaccio-based smoke test for npm tarball packaging?

A Verdaccio-based smoke test for npm tarball packaging is a local workflow that builds, publishes, packs, and validates a package artifact against a private registry. It verifies binary exposure and dependency rewrites without touching the public npm registry.

Do I need pnpm to pack and smoke-test a web package CLI?

Yes, you need pnpm and Node installed in your repository environment to pack and smoke-test the web package CLI. The workflow requires running from the repository root to correctly execute the Verdaccio-based validation.

Can I validate the bin and dist-serve layout of a package before npm publish?

Yes, you can validate the bin and dist-serve layout of a package before npm publish by creating a tarball and running a smoke test. This pre-release check identifies packaging failures and verifies CLI distribution quality in CI.

What's the best way to verify npm distribution quality for a CLI package in CI?

The best way to verify npm distribution quality for a CLI package in CI is running a Verdaccio-based smoke workflow. It packs the package into a tarball and executes the CLI via npx to ensure binary exposure and dependency rewrites function correctly.