This is a complete starter kit for building CLI tools that run via npx, using Bun for development but targeting Node.js for distribution. It scaffolds the full setup: citty for argument parsing, Bunup for bundling, dual package structure if you want both a library API and a binary, plus the whole TypeScript strict mode and testing rig. The opinonated part is good here: it forces the shebang to use node not bun, makes you separate CLI wiring from actual logic so tests don't spawn processes for every assertion, and includes both Biome and ESLint because one is fast and the other catches type-level mistakes. If you're publishing something people will npx, this handles the easy-to-mess-up parts like the bin field and executable permissions.

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

Install

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

Installs into .claude/skills of the current project.

Files

npx CLI Tool Development (Bun-First)

Build and publish npx-executable command-line tools using Bun as the primary runtime and toolchain, producing binaries that work for all npm/npx users (Node.js runtime).

When to Use This Skill

Use when:

  • Creating a new CLI tool from scratch
  • Building an npx-executable binary
  • Setting up argument parsing, sub-commands, or terminal UX for a CLI
  • Publishing a CLI tool to npm
  • Adding a CLI to an existing library package

Do NOT use when:

  • Building a library without a CLI (use the npm-package 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, AI & Agent Building, Release Management, CLI & Terminal
First seen
Jun 3, 2026

More from jwynia/agent-skills

All 118
1microsoft 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
2pbnicad 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
3wix avatarwix-cli-app-validationwix/skillsUse when testing app readiness, verifying runtime behavior, or validating before releases and after changes in the code. Triggers include validate, test, verify287skills.sh installs
4davila7 avatarloki-modedavila7/claude-code-templatesMulti-agent autonomous startup system for Claude Code. Triggers on "Loki Mode". Orchestrates 100+ specialized agents across engineering, QA, DevOps, security, d284skills.sh installs
5microsoft avatarcomponent-fixturesmicrosoft/vscodeUse when creating or updating component fixtures for screenshot testing, or when designing UI components to be fixture-friendly. Covers fixture file structure, 277skills.sh installs
6andreadellacorte avataragent-browserandreadellacorte/grooveBrowser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking scr273skills.sh installs