Agent skill

Npx CLI

by jwynia in jwynia/agent-skills

Build and publish npx-executable CLI tools using Bun as the primary toolchain with npm-compatible output.

No licenceAuto-check passedDevelopment

Install Npx CLI

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jwynia/agent-skills npx-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/tech/development/tooling/npx-cli .claude/skills/npx-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
npx-cli
GitHub stars
166
Token cost
~2.4k tokens
SKILL.md length
736 words
Files
18 (incl. scripts)
Skills in repo
112
Repo updated
First seen
Licence
None found

At a glance

Build and publish npx-executable CLI tools using Bun as the primary toolchain with npm-compatible output.

  • Works in 3 steps: Parses arguments with citty → Calls into the library/core modules → Formats output for the terminal
  • The user wants to create a new CLI tool
  • SKILL.md covers When to Use This Skill, Toolchain, Scaffolding a New CLI and Project Structure, plus 9 more sections
  • Runs TypeScript scripts from its folder; calls bun, node and bunx; needs NPM_CONFIG_TOKEN and NODE_AUTH_TOKEN

What it does

Npx CLI is an agent skill from jwynia/agent-skills. Build 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 up a command-line package for npx execution, configure argument parsing and terminal output, or publish a CLI to npm. Covers scaffolding, citty arg parsing, sub-commands, terminal UX, strict TypeScript, Biome + ESLint linting, Vitest testing, Bunup bundling, and publishing workflows. Keywords: npx, cli, command-line, binary, bin, tool, bun, citty…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts (for example `reference/cli-patterns.md`, `reference/esm-cjs-guide.md` and `reference/publishing-workflow.md`).

It sits in Development, covering Linting and formatting, Unit testing and Project scaffolding. It works with npm, TypeScript, Vitest and ESLint.

When your agent uses it

  • The user wants to create a new CLI tool
  • Set up a command-line package for npx execution
  • Configure argument parsing and terminal output
  • Publish a CLI to npm

Example prompts

  • “/npx-cli”

Requirements

  • Node.js
  • A credential in NPM_CONFIG_TOKEN
  • A credential in NODE_AUTH_TOKEN

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Parses arguments with citty
  2. Calls into the library/core modules
  3. Formats output for the terminal

What it can do on your machine

Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (TypeScript, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • bun
    • node
    • bunx
    • npm
    • tsc

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use bunx and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NPM_CONFIG_TOKEN
    • NODE_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Npx CLI loads about 2.4k tokens when it runs. Until then it costs about 144 tokens; SKILL.md has 736 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~144
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 736 words (~2,374 tokens).

“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).”

— opening of SKILL.md by jwynia
name
npx-cli

Read the full SKILL.md on GitHub

Files

SKILL.md and 17 other files (scripts) in skills/tech/development/tooling/npx-cli of jwynia/agent-skills.

  • SKILL.md
  • reference/cli-patterns.md
  • reference/esm-cjs-guide.md
  • reference/publishing-workflow.md
  • reference/strict-typescript.md
  • scripts/scaffold.ts
  • templates/biome.json
  • templates/bunup.config.ts
  • templates/eslint.config.ts
  • templates/gitignore
  • templates/package.json.hbs
  • templates/scripts/postbuild.ts
  • templates/src/cli.test.ts.hbs
  • templates/src/cli.ts.hbs
  • templates/src/index.test.ts.hbs
  • templates/src/index.ts.hbs
  • … and 2 more

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Npx CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Npx CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Npx CLI this skilljwynia/agent-skills166—~2.4kAutomated safety check: PassNone
Create Saleor Packagesaleor/apps162—~608Automated safety check: PassCustom licence
Typescript ToolingHoangNguyen0403/agent-skills-standard571—~688Automated safety check: PassMIT
Antfuoyjt/uniapp-vue3-template627—~1.3kAutomated safety check: PassMIT
Eslint Vitest Rule Testerantfu-collective/eslint-vitest-rule-tester142—~1.3kAutomated safety check: PassMIT
Implementing Lint Rulesflint-fyi/flint312—~857Automated safety check: PassMIT

Similar skills

  • Scaffold a new shared package in the saleor-apps monorepo under ./packages/.

    162 GitHub stars~608 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Typescript Tooling

    HoangNguyen0403/agent-skills-standard

    Development tools, linting, and build config for TypeScript.

    571 GitHub stars~688 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Antfu

    oyjt/uniapp-vue3-template

    Anthony Fu's {Opinionated} preferences and best practices for web development

    627 GitHub stars~1.3k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • Eslint Vitest Rule Tester

    antfu-collective/eslint-vitest-rule-tester

    Help users test ESLint rules with Vitest, supporting snapshot testing and custom assertions

    142 GitHub stars~1.3k tokensUpdated 28 days ago
    Testing & QAAuto-check passed
  • Implements ESLint-style lint rules with proper AST handling, targeted reporting, and comprehensive unit tests.

    312 GitHub stars~857 tokensUpdated today
    DevelopmentAuto-check passed
  • Vite Plus Conventions

    Goldziher/ai-rulez

    vite+ unified TypeScript toolchain conventions: the vp CLI for package/node management, oxlint/oxfmt, type-aware linting, vitest, rolldown/tsdown bundling, task caching, and migration.

    158 GitHub stars~567 tokensUpdated today
    DevelopmentAuto-check passed

More from jwynia/agent-skills

All 112 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    166 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check: notes
  • Frontend Design

    jwynia/agent-skills

    Create distinctive, production-grade frontend interfaces with high design quality.

    166 GitHub stars~3.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Gitea Workflow

    jwynia/agent-skills

    Orchestrate agile development workflows for Gitea repositories using the tea CLI.

    166 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Godot Asset Generator

    jwynia/agent-skills

    Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.

    166 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Mastra Hono

    jwynia/agent-skills

    Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.

    166 GitHub stars~2.9k tokensUpdated 7 mo ago
    Auto-check passed
  • PPTX Generator

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

    166 GitHub stars~3.1k tokensUpdated 7 mo ago
    Auto-check passed

Questions about Npx CLI

What does Npx CLI do?

Build and publish npx-executable CLI tools using Bun as the primary toolchain with npm-compatible output. Npx CLI is an agent skill from jwynia/agent-skills. Build and publish npx-executable CLI tools using Bun as the primary toolchain with npm-compatible output.

When should I use Npx CLI?

Npx CLI fits situations like: the user wants to create a new CLI tool; set up a command-line package for npx execution; configure argument parsing and terminal output; publish a CLI to npm.

How do I install Npx CLI in Claude Code?

Run `npx skills add jwynia/agent-skills --skill npx-cli -a claude-code`. Or copy the skill folder (skills/tech/development/tooling/npx-cli in jwynia/agent-skills) into .claude/skills/npx-cli in your project. Claude Code loads it when a task matches its description.

How do I install Npx CLI in Codex?

Run `npx skills add jwynia/agent-skills --skill npx-cli -a codex`. Or copy the skill folder (skills/tech/development/tooling/npx-cli in jwynia/agent-skills) into .agents/skills/npx-cli in your project. Codex loads it when a task matches its description.

Can I use Npx CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill npx-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/npx-cli, .gemini/skills/npx-cli, .github/skills/npx-cli and .opencode/skills/npx-cli in your project.

What does Npx CLI need to run?

Going by SKILL.md and its folder, Npx CLI needs TypeScript for the scripts in its folder, the command-line tools its instructions call (bun, node, bunx, npm and tsc) and credentials named NPM_CONFIG_TOKEN and NODE_AUTH_TOKEN. Our summary lists: Node.js; A credential in NPM_CONFIG_TOKEN; A credential in NODE_AUTH_TOKEN.

Does Npx CLI access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Npx CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Npx CLI use?

No licence was found for Npx CLI or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Npx CLI use?

About 2.4k tokens (SKILL.md is roughly 9.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Npx CLI?

Skills that share tags, products or a category with Npx CLI: Create Saleor Package (saleor/apps, 162 stars), Typescript Tooling (HoangNguyen0403/agent-skills-standard, 571 stars), Antfu (oyjt/uniapp-vue3-template, 627 stars) and Eslint Vitest Rule Tester (antfu-collective/eslint-vitest-rule-tester, 142 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Npx CLI?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 166 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on February 24, 2026.

Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.