# npm-package-dev

The npm-package-dev Claude Code skill guides npm package creation and publishing. It activates for requests about package.json, the npm registry, or package release.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 326 repo stars
- Author: mrhlaingbwardev
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mrhlaingbwardev/agentic-hacking-skills/tree/HEAD/skills/npm-package-dev/SKILL.md
- Updated: 2026-11-01
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/npm-package-dev

## What it does

The skill walks through setting up an npm package, from its `package.json` and source files to tests and documentation. It covers package metadata, dependencies, versioning, and which files to include in a release. Publishing requires an npm account and a CLI session started with `npm login`.

It also outlines pre-release checks, a dry run with `npm publish --dry-run`, and publishing with `npm publish`. Lifecycle scripts such as `preinstall` and `postinstall` can run code on a user's machine, creating a supply-chain security concern. Security research is limited to authorized work.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill npm-package-dev -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/npm-package-dev/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/npm-package-dev/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill npm-package-dev -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/npm-package-dev/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill npm-package-dev -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/npm-package-dev/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mrhlaingbwardev/agentic-hacking-skills skills/npm-package-dev
```

2. **Manually: put the files in place**
- File: `.github/skills/npm-package-dev/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add mrhlaingbwardev/agentic-hacking-skills --skill npm-package-dev -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/mrhlaingbwardev/agentic-hacking-skills --path skills/npm-package-dev
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/npm-package-dev/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/mrhlaingbwardev/agentic-hacking-skills/tree/HEAD/skills/npm-package-dev/SKILL.md

## When to use it
- scaffold an npm package and configure its `package.json`
- prepare tests and documentation for a library
- inspect package contents before release
- choose version and publishing commands

## Example prompts
- Create an npm package for this library and set up its `package.json`.
- Check which files will go into the npm release.
- Prepare this package for npm publishing and list the release commands.

## Similar
- [updating-npm-package](https://affpapa.org/en/nevibecode/skills/updating-npm-package.md) — skill · 438 installs
- [npm-package](https://affpapa.org/en/nevibecode/skills/npm-package.md) — skill · 335 installs
- [list-npm-package-content](https://affpapa.org/en/nevibecode/skills/list-npm-package-content.md) — skill · 22 installs
- [check-npm](https://affpapa.org/en/nevibecode/skills/check-npm.md) — skill · 3200 installs
- [sandbox-npm-install](https://affpapa.org/en/nevibecode/skills/sandbox-npm-install.md) — skill · 1700 installs
- [npm-security-best-practices](https://affpapa.org/en/nevibecode/skills/npm-security-best-practices.md) — skill · 925 installs

From the same set: [mrhlaingbwardev/agentic-hacking-skills](https://affpapa.org/en/nevibecode/by/mrhlaingbwardev/agentic-hacking-skills.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
