Agent skill

bun

Use Bun instead of Node.js, npm, pnpm, or vite. Provides command mappings, Bun-specific APIs, and development patterns.

Stars 310
Forks 28

Install this agent skill to your Project

npx add-skill https://github.com/brianlovin/agent-config/tree/main/skills/bun

SKILL.md

Bun Runtime

Use Bun as the default JavaScript/TypeScript runtime and package manager.

Command Mappings

Instead of Use
node file.ts bun file.ts
ts-node file.ts bun file.ts
npm install bun install
npm run script bun run script
jest / vitest bun test
webpack / esbuild bun build

Bun automatically loads .env files - don't use dotenv.

Bun-Specific APIs

Prefer these over Node.js equivalents:

API Purpose Don't use
Bun.serve() HTTP server with WebSocket, HTTPS, routes express
bun:sqlite SQLite database better-sqlite3
Bun.redis Redis client ioredis
Bun.sql Postgres client pg, postgres.js
Bun.file() File operations node:fs readFile/writeFile
Bun.$\cmd`` Shell commands execa
WebSocket WebSocket client (built-in) ws

Testing

Use bun:test for tests:

ts
import { test, expect } from "bun:test";

test("description", () => {
  expect(1).toBe(1);
});

Run with bun test.

Frontend Development

Use HTML imports with Bun.serve() instead of Vite. Supports React, CSS, Tailwind.

Server:

ts
import index from "./index.html"

Bun.serve({
  routes: {
    "/": index,
    "/api/users/:id": {
      GET: (req) => Response.json({ id: req.params.id }),
    },
  },
  development: { hmr: true, console: true }
})

HTML file:

html
<html>
  <body>
    <script type="module" src="./app.tsx"></script>
  </body>
</html>

Bun's bundler transpiles .tsx, .jsx, .js automatically. CSS is bundled via <link> tags.

Run with bun --hot ./server.ts for HMR.

Documentation

For detailed API docs, see node_modules/bun-types/docs/**.md.

Expand your agent's capabilities with these related and highly-rated skills.

brianlovin/agent-config

tdd

Test-driven development with red-green-refactor loop. Use when user wants to build features or fix bugs using TDD, mentions "red-green-refactor", wants integration tests, or asks for test-first development.

310 28
Explore
brianlovin/agent-config

fix-sentry-issues

Use Sentry MCP to discover, triage, and fix production issues with root-cause analysis. Use when asked to fix Sentry issues, triage production errors, investigate error spikes, or clean up Sentry noise. Requires Sentry MCP server. Triggers on "fix sentry", "triage errors", "production bugs", "sentry issues".

310 28
Explore
brianlovin/agent-config

workflow

Workflow orchestration for complex coding tasks. Use for ANY non-trivial task (3+ steps or architectural decisions) to enforce planning, subagent strategy, self-improvement, verification, elegance, and autonomous bug fixing. Triggers: multi-step implementation, bug fixes, refactoring, architectural changes, or any task requiring structured execution.

310 28
Explore
brianlovin/agent-config

react-doctor

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

310 28
Explore
brianlovin/agent-config

playwriter

Control the user's currently open Chrome tab through the Playwriter CLI (no new browser launch). Use when you need to inspect live UI state, run scripted browser actions, capture console output, or reproduce frontend issues directly in the user's tab.

310 28
Explore
brianlovin/agent-config

deslop

Remove AI-generated code slop from the current branch. Use after writing code to clean up unnecessary comments, defensive checks, and inconsistent style.

310 28
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results