Agent skill

npm Package

by jwynia in jwynia/agent-skills

Build and publish npm packages using Bun as the primary toolchain with npm-compatible output.

No licenceAuto-check passedDevelopment

Install npm Package

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

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

GitHub CLI
$ gh skill install jwynia/agent-skills npm-package --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/npm-package .claude/skills/npm-package && 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
npm-package
GitHub stars
170
Token cost
~2.1k tokens
SKILL.md length
773 words
Files
14 (incl. scripts)
Skills in repo
111
Repo updated
First seen
Licence
None found

At a glance

Build and publish npm packages using Bun as the primary toolchain with npm-compatible output.

  • Works in 6 steps: Always use "type": "module" in… → Always use exports field, not main. main… → types must be the first condition in… → …
  • The user wants to create a new npm library
  • SKILL.md covers When to Use This Skill, Toolchain, Scaffolding a New Package and Project Structure, plus 6 more sections
  • Runs TypeScript scripts from its folder; calls bun, npm and bunx; needs NPM_CONFIG_TOKEN and NODE_AUTH_TOKEN

What it does

npm Package is an agent skill from jwynia/agent-skills. Build and publish npm packages using Bun as the primary toolchain with npm-compatible output. Use when the user wants to create a new npm library, set up a TypeScript package for publishing, configure build/test/lint tooling for a package, fix CJS/ESM interop issues, or publish to npm. Covers scaffolding, strict TypeScript, Biome + ESLint linting, Vitest testing, Bunup bundling, and publishing workflows. Keywords: npm, package, library, publish, bun, bunup, esm, cjs, exports, typescript, biome, vitest, changesets.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 17 other files, including scripts (for example `reference/esm-cjs-guide.md`, `reference/publishing-workflow.md` and `reference/strict-typescript.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 npm library
  • Set up a TypeScript package for publishing
  • Configure build/test/lint tooling for a package
  • Fix CJS/ESM interop issues

Example prompts

  • “/npm-package”

Requirements

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

Workflow steps

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

  1. Always use "type": "module" in package.json. ESM-only is the correct default. require(esm) works in all supported Node.js versions.
  2. Always use exports field, not main. main is legacy. exports gives precise control over what consumers can access.
  3. types must be the first condition in every exports block. TypeScript silently fails to resolve types if it isn't.
  4. Always export "./package.json": "./package.json". Many tools need access to the package.json and exports encapsulates completely.
  5. Use files: ["dist"] in package.json. Whitelist approach prevents shipping secrets. Never use .npmignore.
  6. Run npm pack --dry-run before every publish. Verify the tarball contains exactly what you intend.

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), which the agent can run.

    Shell commands in SKILL.md call:

    • bun
    • npm
    • bunx
    • tsc

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

  • Network

    No URLs in SKILL.md. Its commands use npm and bunx, 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

npm Package loads about 2.1k tokens when it runs. Until then it costs about 133 tokens; SKILL.md has 773 words of instructions outside code blocks.

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

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 773 words (~2,096 tokens).

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

— opening of SKILL.md by jwynia
name
npm-package

Read the full SKILL.md on GitHub

Files

SKILL.md and 13 other files (scripts) in skills/tech/development/tooling/npm-package of jwynia/agent-skills.

  • SKILL.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/src/index.test.ts.hbs
  • templates/src/index.ts.hbs
  • templates/tsconfig.json
  • templates/vitest.config.ts

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

npm Package 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.

npm Package compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
npm Package this skilljwynia/agent-skills170—~2.1kAutomated safety check: PassNone
Create Saleor Packagesaleor/apps162—~608Automated safety check: PassCustom licence
Antfuoyjt/uniapp-vue3-template627—~1.3kAutomated safety check: PassMIT
Typescript ToolingHoangNguyen0403/agent-skills-standard572—~688Automated 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 2 days ago
    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
  • Typescript Tooling

    HoangNguyen0403/agent-skills-standard

    Development tools, linting, and build config for TypeScript.

    572 GitHub stars~688 tokensUpdated today
    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 1 mo 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
  • Igniteui Angular Linting

    IgniteUI/igniteui-angular

    Quick-reference for linting the core Ignite UI for Angular library.

    599 GitHub stars~614 tokensUpdated today
    DevelopmentAuto-check passed

More from jwynia/agent-skills

All 111 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    170 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.

    170 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.

    170 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.

    170 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.

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

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

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

Categories

Questions about npm Package

What does npm Package do?

Build and publish npm packages using Bun as the primary toolchain with npm-compatible output. npm Package is an agent skill from jwynia/agent-skills. Build and publish npm packages using Bun as the primary toolchain with npm-compatible output.

When should I use npm Package?

npm Package fits situations like: the user wants to create a new npm library; set up a TypeScript package for publishing; configure build/test/lint tooling for a package; fix CJS/ESM interop issues.

How do I install npm Package in Claude Code?

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

How do I install npm Package in Codex?

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

Can I use npm Package 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 npm-package -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/npm-package, .gemini/skills/npm-package, .github/skills/npm-package and .opencode/skills/npm-package in your project.

What does npm Package need to run?

Going by SKILL.md and its folder, npm Package needs TypeScript for the scripts in its folder, the command-line tools its instructions call (bun, npm, bunx 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 npm Package 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 npm Package 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 npm Package use?

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

How many tokens does npm Package use?

About 2.1k tokens (SKILL.md is roughly 8.4k 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 npm Package?

Skills that share tags, products or a category with npm Package: Create Saleor Package (saleor/apps, 162 stars), Antfu (oyjt/uniapp-vue3-template, 627 stars), Typescript Tooling (HoangNguyen0403/agent-skills-standard, 572 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 npm Package?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 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.