npm-package — скилл для Claude Code: сборка и публикация npm-пакетов
Скилл ведёт агента через создание npm-библиотеки на Bun: скаффолдинг, строгий TypeScript, тесты, сборка и публикация.
npx skills add jwynia/agent-skills --skill npm-package -a claude-codeЧто делает npm-package
Скилл описывает весь путь npm-пакета: от пустой папки до npm publish. Внутри — скрипт scaffold.ts, который разворачивает структуру проекта, набор правил по конфигурации и справочные документы по exports, строгому TypeScript и публикации. Агент опирается на них, когда правит package.json, tsconfig.json или bunup.config.ts.
Инструменты расставлены жёстко: Bun как рантайм и пакетный менеджер, Bunup для сборки и генерации .d.ts, Biome для форматирования, ESLint с typescript-eslint для правил, которым нужны типы, Vitest для тестов, Changesets для версий. Скилл прямо запрещает any, main вместо exports и paths в публикуемом пакете — tsc не переписывает алиасы, и потребитель их не разрешит.
Есть границы применимости. Скилл рассчитан на одиночный пакет, а не на монорепозиторий, и не подходит для CLI под npx или для приложения. Сборка идёт через Bunup, поэтому без Bun в проекте шаги из скилла не выполнятся.
Какие задачи решает
- развернуть структуру нового npm-пакета с нуля
- настроить строгий tsconfig для публикуемой библиотеки
- починить карту
exportsи интероп CJS/ESM - собрать двойной вывод ESM и CJS с типами
- подготовить релиз через Changesets и публикацию с provenance
Примеры запросов агенту
- Создай новый npm-пакет my-lib через скилл npm-package
- Проверь
exportsв package.json и почини интероп CJS/ESM - Настрой Vitest с порогом покрытия и собери пакет через Bunup
Как установить npm-package
1Через Skills CLI (Vercel)
npx skills add jwynia/agent-skills --skill npm-package -a claude-code2Вручную: положить файлы
~/.claude/skills/npm-package/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/npm-package/
1Через Skills CLI (Vercel)
npx skills add jwynia/agent-skills --skill npm-package -a codex2Вручную: положить файлы
.agents/skills/npm-package/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jwynia/agent-skills --skill npm-package -a cursor2Вручную: положить файлы
.cursor/skills/npm-package/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jwynia/agent-skills npm-package2Вручную: положить файлы
.github/skills/npm-package/SKILL.md1Через Skills CLI (Vercel)
npx skills add jwynia/agent-skills --skill npm-package -a gemini-cli2Командой платформы
gemini skills install https://github.com/jwynia/agent-skills --path skills/tech/development/tooling/npm-packageВручную: положить файлы
.devin/skills/npm-package/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jwynia/agent-skills --skill npm-package -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о npm-package
Как установить npm-package в Claude?
Выполните npx skills add jwynia/agent-skills --skill npm-package -a claude-code. После этого файл скилла лежит по пути ~/.claude/skills/npm-package/SKILL.md.
Что делает npm-package?
Проводит агента по созданию и публикации npm-библиотеки: скаффолдинг, строгий TypeScript, линтинг, тесты, сборка и релиз. Работает с Bun как основным инструментом, а на выходе даёт пакет, совместимый с npm.
Подойдёт ли скилл для монорепозитория?
Нет, он рассчитан на репозиторий с одним пакетом. Для CLI под npx и для приложений тоже не подходит.
