| name | node |
| description | Use when working with Node.js, npm, package.json, or npx. Alternative package managers
like Yarn and pnpm as well as monorepo tools like nx, yarn, or turborepo should also use this skill
|
Node.js
Invoking scripts
Prefer explicit scripts entries over npx. Write scripts to package.json:
"scripts": {
"test": "vitest run",
"dev": "vitest --watch",
"build": "vite build"
}
Reason: Enforces consistent flags, prevents drift, works better in monorepos.
Monorepos
Use native npm workspaces unless user explicitly chose otherwise (turborepo, nx, pnpm).
Workspace pattern (examples/workspace-setup):
- Root
workspaces: ["packages/**"] in package.json
- Workspace scripts:
npm run build -ws, npm run test -ws
- Local deps use workspace names:
@bifrost-ai/core
TypeScript project references (examples/tsconfig-references):
- Base config with
composite: true
- Package configs extend base, declare
references
- Enables cross-package type checking, faster builds
Build (examples/vite-build):
- Vite for fast builds
vite-plugin-dts for .d.ts generationexternal: workspace deps in rollupOptions
Testing (examples/vitest-setup):
- Vitest config per workspace or root
*.spec.ts naming, exclude from builds- Root script runs all:
"test": "vitest run"
See also
