This is a complete, opinionated setup for building npm packages with Bun as the runtime and Bunup as the bundler. It scaffolds the entire project structure, locks in strict TypeScript with `module: nodenext`, wires up Biome for fast linting plus ESLint for type-aware rules, configures Vitest for isolated testing, and sets up Changesets for versioning. The 18 non-negotiable rules are the real value here: they're drawn from the sharp edges that actually break published packages, like putting `types` first in the exports map, never using path aliases, and always running `npm pack --dry-run` before publishing. Use this when you're shipping a library to npm and want the tooling decisions made for you with clear reasoning attached.

skills.sh installs
334
GitHub stars
182
last updated
Aug 21, 2026

Install

$ npx -y skills add jwynia/agent-skills --skill npm-package --agent claude-code

Installs into .claude/skills of the current project.

Files

npm Package Development (Bun-First)

Build and publish npm packages using Bun as the primary runtime and toolchain, producing output that works everywhere npm packages are consumed.

When to Use This Skill

Use when:

  • Creating a new npm library package from scratch
  • Setting up build/test/lint tooling for an existing package
  • Fixing CJS/ESM interop, exports map, or TypeScript declaration issues
  • Publishing a package to npm
  • Reviewing or improving package configuration

Do NOT use when:

  • Building an npx-executable CLI tool (use the npx-cli skill)
  • Building an application (not a published package)
  • Working in a monorepo (this skill targets single-package repos)

Toolchain

Sponsors

Details

Repository
github.com/jwynia/agent-skills
Categories
Testing & QA, DevOps & CI/CD, Code Review & Quality, AI & Agent Building, Release Management, Debugging
First seen
Jun 3, 2026

More from jwynia/agent-skills

All 118
1jezweb avatarcloudflare-vectorizejezweb/claude-skillsBuild semantic search with Cloudflare Vectorize V2. Covers async mutations, 5M vectors/index, 31ms latency, returnMetadata enum changes, and V1 deprecation. Pre326skills.sh installs
2checkly avatarchecklycheckly/checkly-cliSet up, create, test and manage monitoring checks using the Checkly CLI. Use when working with API Checks, Browser Checks, URL Monitors, ICMP Monitors, Playwrig321skills.sh installs
3mims-harvard avatardevtu-self-evolvemims-harvard/tooluniverseOrchestrate the full ToolUniverse self-improvement cycle: discover APIs, create tools, test with researcher personas, fix issues, optimize skills, and push via 310skills.sh installs
4jwynia avatarnpx-clijwynia/agent-skillsBuild and publish npx-executable CLI tools using Bun as the primary toolchain with npm-compatible output. Use when the user wants to create a new CLI tool, set 307skills.sh installs
5microsoft avatarlaunchmicrosoft/vscodeLaunch Code OSS (VS Code from sources) into an isolated throwaway profile with unique debug ports so you can drive it with @playwright/cli AND attach a Node deb304skills.sh installs
6pbnicad avatartelegram-bot-grammypbnicad/telegram-bot-grammy-skillTelegram Bot development skill using grammY framework, TypeScript, Drizzle ORM, Vitest testing, Biome linting, deployed to Cloudflare Workers with D1 database. 292skills.sh installs