# npx-cli

Помогает создать, настроить и выпустить в npm консольную утилиту, запускаемую через npx. Скилл опирается на Bun при разработке, но собирает бинарник под Node.js.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 304 установки · ★ 177
- Автор: jwynia
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jwynia/agent-skills/tree/HEAD/skills/tech/development/tooling/npx-cli/SKILL.md
- Обновлён: 2026-02-24
- HTML: https://affpapa.org/nevibecode/skills/npx-cli

## Что делает

Скилл разворачивает проект для запуска через `npx` с разделением логики и консольной обвязки. Сборка упаковывает ядро библиотеки отдельно от точки входа утилиты, либо готовит чисто консольный пакет без публичного программного API. Парсинг флагов строится на библиотеке `citty`, цвета выводятся через `picocolors`, а сборку выполняет `Bunup`.

Для проверки кода скилл конфигурирует TypeScript в строгом режиме, `Biome` и `ESLint`, а тесты перекладывает на `Vitest`. Публикация оформляется через `Changesets` с флагом провенанса. При этом в скомпилированный файл строго прописывается шебанг `#!/usr/bin/env node`. Пользователям утилиты не нужен Bun на машине, потому что рантаймом для npx остаётся Node.js.

Этот рабочий процесс рассчитан только на отдельные репозитории с одним пакетом. С монорепозиториями скилл не работает, а для библиотек без консольного интерфейса автор советует другой сценарий.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jwynia/agent-skills --skill npx-cli -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/npx-cli/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/npx-cli/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jwynia/agent-skills --skill npx-cli -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/npx-cli/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jwynia/agent-skills --skill npx-cli -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/npx-cli/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jwynia/agent-skills npx-cli
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/npx-cli/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jwynia/agent-skills --skill npx-cli -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jwynia/agent-skills --path skills/tech/development/tooling/npx-cli
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/npx-cli/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jwynia/agent-skills --skill npx-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jwynia/agent-skills/tree/HEAD/skills/tech/development/tooling/npx-cli/SKILL.md

## Когда брать
- настроить новый CLI-пакет под запуск через `npx`
- сконфигурировать разбор аргументов командной строки на `citty`
- отделить прикладную логику от файла точки входа для юнит-тестов
- настроить сборку двойного пакета с экспортом библиотеки и бинарника
- подготовить релиз в npm с `Changesets` и аттестацией provenance

## Примеры запросов агенту
- Помоги создать проект для npx-утилиты с аргументами input и output
- Сконфигурируй подкоманды для CLI через citty и настрой picocolors
- Подготовь package.json и bunup.config.ts для публикации CLI-пакета в npm

## Похожие
- [bun-runtime](https://affpapa.org/nevibecode/skills/secondsky-bun-runtime.md) — скилл · 414 установок
- [insforge-cli](https://affpapa.org/nevibecode/skills/insforge-cli.md) — скилл · 60500 установок
- [bun-sqlite](https://affpapa.org/nevibecode/skills/bun-sqlite.md) — скилл · 495 установок
- [typescript-scaffold](https://affpapa.org/nevibecode/commands/typescript-scaffold.md) — команда · ★ 41823
- [javascript-testing-patterns](https://affpapa.org/nevibecode/skills/javascript-testing-patterns.md) — скилл · 20472 установки
- [antfu](https://affpapa.org/nevibecode/skills/antfu.md) — скилл · 16900 установок

Из того же набора: [jwynia/agent-skills](https://affpapa.org/nevibecode/by/jwynia/agent-skills.md) — 113 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md