#601

Global Rank · of 601 Skills

bun-runtime AI Agent Skill

View Source: oakoss/agent-skills

Safe

Installation

npx skills add oakoss/agent-skills --skill bun-runtime

33

Installs

Bun Runtime

Overview

Bun is an all-in-one JavaScript and TypeScript runtime that includes a fast package manager, bundler, test runner, and Node.js-compatible APIs. It natively executes TypeScript and JSX without a separate compilation step.

When to use: Fast server-side JavaScript, TypeScript-first projects, replacing Node.js for better startup performance, built-in SQLite, password hashing, file I/O, HTTP servers, bundling, and testing without external tooling.

When NOT to use: Projects requiring full Node.js ecosystem compatibility (some native modules unsupported), production environments needing battle-tested stability of Node.js, or browser-only code that does not need a runtime.

Quick Reference

Pattern API Key Points
HTTP server Bun.serve({ routes, fetch }) Route-based, static/dynamic routes, per-method handlers
File read Bun.file(path) Lazy BunFile (Blob), .text(), .json(), .stream()
File write Bun.write(dest, data) Accepts string, Blob, Response, BunFile
SQLite new Database(path) from bun:sqlite Synchronous queries, prepared statements, WAL mode
Password hash Bun.password.hash(pw) Argon2id default, bcrypt option, async and sync variants
Password verify Bun.password.verify(pw, hash) Auto-detects algorithm from hash format
Bundler Bun.build({ entrypoints, outdir }) Tree-shaking, code splitting, plugins, multiple targets
Test runner import { test, expect } from "bun:test" Jest-compatible, mocking, snapshots, watch mode
Install packages bun install Fast lockfile resolution, npm-compatible
Add package bun add <pkg> -d for dev, -g for global
Run script bun run <script> Runs package.json scripts or files directly
Execute binary bunx <pkg> Like npx, runs without installing
S3 client new S3Client(opts) / s3.file(key) Built-in S3-compatible storage client
HTML imports import page from './index.html' Fullstack: import HTML as route handler

Common Mistakes

Mistake Correct Pattern
Using fetch handler only without routes Use routes object for static/dynamic routing (Bun v1.2.3+), fetch as fallback
Forgetting await on Bun.write() Bun.write() is async, always await it
Using Bun.file(path).text() without await .text(), .json(), .arrayBuffer() all return Promises
Creating SQLite database without WAL mode Enable WAL for concurrent reads: db.exec("PRAGMA journal_mode = WAL")
Using bun install without --frozen-lockfile in CI Use bun install --frozen-lockfile for reproducible CI builds
Importing jest globals in Bun tests Import from bun:test, not @jest/globals or vitest
Using node_modules/.bin/ directly Use bunx or bun run instead of referencing bin paths
Expecting Bun.build() to throw on failure Check result.success boolean, errors are in result.logs
Using --target node when deploying to Bun Use --target bun for Bun-specific optimizations and bytecode
Synchronous password hashing in request handlers Use await Bun.password.hash() async variant in servers

Delegation

  • Project scaffolding: Use Explore agent
  • Performance profiling: Use Task agent
  • Code review: Delegate to code-reviewer agent

If the typescript-patterns skill is available, delegate advanced TypeScript typing questions to it.

References

Installs

Installs 33
Global Rank #601 of 601

Security Audit

ath Safe
socket Safe
Alerts: 0 Score: 90
snyk Low
EU EU-Hosted Inference API

Power your AI Agents with the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

How to use this skill

1

Install bun-runtime by running npx skills add oakoss/agent-skills --skill bun-runtime in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.

2

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

3

The skill enhances your agent's understanding of bun-runtime, helping it follow established patterns, avoid common mistakes, and produce production-ready output.

What you get

Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.

Compatibility

This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

EU Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing
Customer Support