Agent skill

Bun Win32

by involvex in involvex/youtube-music-cli

Win32 FFI binding lifecycle for @bun-win32/ packages (Win32 DLL bindings via bun:ffi on Windows).

MITAuto-check passedFrontend & Design

Install Bun Win32

skills CLI
$ npx skills add involvex/youtube-music-cli --skill bun-win32 -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install involvex/youtube-music-cli bun-win32 --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/involvex/youtube-music-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/bun-win32 .claude/skills/bun-win32 && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bun-win32
GitHub stars
456
Token cost
~1.1k tokens
SKILL.md length
240 words
Files
13 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Win32 FFI binding lifecycle for @bun-win32/ packages (Win32 DLL bindings via bun:ffi on Windows).

  • Generating a new package from a DLL
  • SKILL.md covers Repository Context, Lifecycle Commands (run from…, Release and Scripts Reference, plus 3 more sections
  • Runs TypeScript scripts from its folder; calls bun and bunx
  • Auditing FFI↔TS↔header consistency

What it does

Bun Win32 is an agent skill from involvex/youtube-music-cli. Win32 FFI binding lifecycle for @bun-win32/ packages (Win32 DLL bindings via bun:ffi on Windows). Use when generating a new package from a DLL, auditing FFI↔TS↔header consistency, fixing nullability (| NULL / | 0n), or understanding the bootstrap→catalog→stub→audit→nullcheck pipeline. Covers 117 packages; strict TypeScript; Bun runtime; Biome formatting.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including scripts and reference files (for example `references/agents.md`, `references/ai-all.md` and `references/ai-core.md`).

It sits in Frontend & Design. It works with Windows, TypeScript, Bun and YouTube. The repository describes itself as: A powerful Terminal User Interface (TUI) music player for YouTube Music. The licence is MIT.

When your agent uses it

  • Generating a new package from a DLL
  • Auditing FFI↔TS↔header consistency
  • Fixing nullability (| NULL / | 0n)
  • Understanding the bootstrap→catalog→stub→audit→nullcheck pipeline

Example prompts

  • “/bun-win32”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit d4c5809. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 9 files in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • bun
    • bunx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use bunx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bun Win32 loads about 1.1k tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from involvex/youtube-music-cli at commit d4c5809, republished under its MIT licence (© involvex). 240 words, ~1,096 tokens.

Download SKILL.mdSave it as .claude/skills/bun-win32/SKILL.md (or your agent's skills folder). This skill also uses 12 other files; get the full folder from GitHub.
name
bun-win32
description
Win32 FFI binding lifecycle for @bun-win32/* packages (Win32 DLL bindings via bun:ffi on Windows). Use when generating a new package from a DLL, auditing FFI↔TS↔header consistency, fixing nullability (| NULL / | 0n), or understanding the bootstrap→catalog→stub→audit→nullcheck pipeline. Covers 117 packages; strict TypeScript; Bun runtime; Biome formatting.
engines
opencode

bun-win32 Skill

Win32 FFI binding development lifecycle for the bun-win32 monorepo.

Repository Context

WORKING_DIR (repo root = ../.. from this skill directory)
  packages/       117 @bun-win32/* binding packages
  scripts/        repo automation scripts
  PROMPT.md       authoritative playbook (FFI rules, nullability, audits)
  AGENTS.md       operating rules — read before touching bindings

This skill dir: skill/bun-win32/
  SKILL.md        ← you are here
  scripts/        automation scripts (run from WORKING_DIR)
  references/     AGENTS.md, ai-core.md, ai-all.md

WORKING_DIR is the repo root. All commands run from there. Scripts in scripts/ use ROOT = join(import.meta.dir, '../..') so they resolve correctly when executed from this skill directory.

Lifecycle Commands (run from WORKING_DIR)

bash
# 1. Check prerequisites (platform Windows, Bun ≥1.3.0, ripgrep, SDK, dumpbin)
bun run skill/bun-win32/scripts/doctor.ts

# 2. Full pipeline: doctor → scaffold → install → catalog → ffi-runtime → stub
bun run skill/bun-win32/scripts/bootstrap.ts {name} [--class=ClassName] [--rg=<path>] [--dll=<path>]

# 3. Individual steps
bun run skill/bun-win32/scripts/catalog.ts {name} --json        # DLL∩SDK symbols
bun run skill/bun-win32/scripts/ffi-runtime.ts {name}            # FFI return shapes
bun run skill/bun-win32/scripts/stub.ts {name} [--class=C]      # paste-ready stubs

# 4. Auditing (run after writing bindings)
bun run skill/bun-win32/scripts/audit.ts {name}        # FFI↔TS↔header consistency (--all, --fix)
bun run skill/bun-win32/scripts/nullcheck.ts {name}    # SAL nullability (--all, --fix, --strict)
bunx tsc --noEmit                                      # type-check the package

Release

bash
rm bun.lock && bun install
bun run skill/bun-win32/scripts/preflight.ts
bun run skill/bun-win32/scripts/nullcheck.ts --all && bun run skill/bun-win32/scripts/audit.ts --all
cd packages/{name} && bun publish --access public --otp <code>

Scripts Reference

ScriptWhat it does
scripts/doctor.tsPrerequisites checker
scripts/bootstrap.tsOrchestrated full pipeline
scripts/catalog.tsdumpbin exports ∩ SDK headers → JSON
scripts/scaffold.tsTemplate → package skeleton
scripts/ffi-runtime.tsProbe FFI return-value shapes
scripts/stub.tscatalog JSON → Symbols + method stubs
scripts/audit.tsFFI↔TS↔header consistency auditor
scripts/nullcheck.tsSAL-driven nullability auditor
scripts/preflight.tsLockfile staleness gate

FFI Type Quick Reference

Win32 typeFFITS
HANDLE, HWND, HKEY, HMODULE…FFIType.u64bigint
SIZE_T, *_PTR, LPARAM, LRESULT, WPARAMFFIType.u64bigint
LARGE_INTEGER, ULARGE_INTEGERFFIType.i64 / u64bigint
DWORD, UINT, BOOL, HRESULT, INT, LONG, WORD, BYTEFFIType.u32 / i32number
LPVOID, LPCWSTR, LPSTR, LPDWORD, LPBYTE…FFIType.ptrPointer
voidFFIType.voidvoid

Decision rule: Does the caller pass .ptr from a Buffer/TypedArray they allocated? Yes → ptr. No → u64.

NULL: u64 → 0n, ptr → null, u32 → 0.

Key Files

  • references/agents.md — full AGENTS.md (binding rules, toolchain, FFI rules, prohibitions)
  • references/ai-core.md — @bun-win32/core contract (Win32 base class, .ptr extension, types)
  • references/ai-all.md — @bun-win32/all contract (re-export aggregator, when to use)
  • PROMPT.md at WORKING_DIR — deep playbook for FFI mapping, nullability, audits

Prohibited

  • Bind exports not confirmed by dumpbin //EXPORTS
  • Guess types/nullability — always verify vs SDK header + MS Learn
  • Use as any / forced casts — fix the FFI mapping instead
  • Reformat untouched files
  • Ship without running audit.ts --all and nullcheck.ts --all (zero findings required)

© involvex, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 12 other files (scripts, references) in .agents/skills/bun-win32 of involvex/youtube-music-cli.

  • SKILL.md
  • references/agents.md
  • references/ai-all.md
  • references/ai-core.md
  • scripts/audit.ts
  • scripts/bootstrap.ts
  • scripts/catalog.ts
  • scripts/doctor.ts
  • scripts/ffi-runtime.ts
  • scripts/nullcheck.ts
  • scripts/preflight.ts
  • scripts/scaffold.ts
  • scripts/stub.ts

Open the folder on GitHubat commit d4c5809

Compare with similar skills

Bun Win32 next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bun Win32 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bun Win32 this skillinvolvex/youtube-music-cli456—~1.1kAutomated safety check: PassMIT
OpenTUI Terminal Interfacescline/cline70k—~1.9kAutomated safety check: PassApache-2.0
holaOS App Builder SDKholaboss-ai/holaOS11k—~11kAutomated safety check: PassCustom licence
Web Artifacts Builderanthropics/skills180k41 repos~769Automated safety check: PassApache-2.0
URL to Markdown FetcherJimLiu/baoyu-skills26k2 repos~2.1kAutomated safety check: PassMIT
Bun DevelopmentGabrielMartinMoran/mind14812 repos~3.5kAutomated safety check: NotesMIT

Similar skills

  • Helps build terminal user interfaces with OpenTUI using its core imperative API or its React and Solid reconcilers, with references for layout, keyboard, animation and testing.

    70k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • holaOS App Builder SDK

    holaboss-ai/holaOS

    Builds new holaOS apps with @holaboss/app-builder-sdk, either as integration-only MCP modules or as dashboard apps with a shadcn UI under src/client/.

    11k GitHub stars~11k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Web Artifacts Builder

    anthropics/skills

    Official

    Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.

    180k GitHub starsUsed in 41 repos~769 tokens
    Frontend & DesignAuto-check passed
  • URL to Markdown Fetcher

    JimLiu/baoyu-skills

    Fetches a web page, X post, YouTube transcript or Hacker News thread through a Chrome-driven CLI and saves it as clean markdown.

    26k GitHub starsUsed in 2 repos~2.1k tokens
    Knowledge ManagementAuto-check passed
  • Bun Development

    GabrielMartinMoran/mind

    Modern JavaScript/TypeScript development with Bun runtime. An agent skill from GabrielMartinMoran/mind.

    148 GitHub starsUsed in 12 repos~3.5k tokens
    Auto-check: notes
  • Ink Tui Wizard

    novuhq/novu

    Build terminal user interfaces (TUIs) using Ink (React for CLIs) and @inkjs/ui with a reactive, session-driven wizard pattern.

    40k GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-check passed

More from involvex/youtube-music-cli

  • React State Management

    involvex/youtube-music-cli

    Master modern React state management with Redux Toolkit, Zustand, Jotai, and React Query.

    456 GitHub starsUsed in 13 repos~3k tokens
    Auto-check passed
  • Bun Build

    involvex/youtube-music-cli

    Create optimized production bundles with Bun's native bundler.

    456 GitHub stars~2.1k tokensUpdated today
    Auto-check: notes
  • Bun Dev Server

    involvex/youtube-music-cli

    Set up high-performance development servers with Hot Module Replacement.

    456 GitHub stars~2.9k tokensUpdated today
    Auto-check: notes
  • Bun Test

    involvex/youtube-music-cli

    Configure Bun's built-in test runner with Jest-compatible APIs.

    456 GitHub stars~2.3k tokensUpdated today
    Auto-check: notes
  • Bun Init

    involvex/youtube-music-cli

    Initialize a new Bun project with TypeScript and optimal configuration.

    456 GitHub stars~2.1k tokensUpdated today
    Auto-check: notes

Questions about Bun Win32

What does Bun Win32 do?

Win32 FFI binding lifecycle for @bun-win32/ packages (Win32 DLL bindings via bun:ffi on Windows). Bun Win32 is an agent skill from involvex/youtube-music-cli. Win32 FFI binding lifecycle for @bun-win32/ packages (Win32 DLL bindings via bun:ffi on Windows).

When should I use Bun Win32?

Bun Win32 fits situations like: generating a new package from a DLL; auditing FFI↔TS↔header consistency; fixing nullability (| NULL / | 0n); understanding the bootstrap→catalog→stub→audit→nullcheck pipeline.

How do I install Bun Win32 in Claude Code?

Run `npx skills add involvex/youtube-music-cli --skill bun-win32 -a claude-code`. Or copy the skill folder (.agents/skills/bun-win32 in involvex/youtube-music-cli) into .claude/skills/bun-win32 in your project. Claude Code loads it when a task matches its description.

How do I install Bun Win32 in Codex?

Run `npx skills add involvex/youtube-music-cli --skill bun-win32 -a codex`. Or copy the skill folder (.agents/skills/bun-win32 in involvex/youtube-music-cli) into .agents/skills/bun-win32 in your project. Codex loads it when a task matches its description.

Can I use Bun Win32 in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add involvex/youtube-music-cli --skill bun-win32 -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bun-win32, .gemini/skills/bun-win32, .github/skills/bun-win32 and .opencode/skills/bun-win32 in your project.

What does Bun Win32 need to run?

Going by SKILL.md and its folder, Bun Win32 needs TypeScript for the scripts in its folder and the command-line tools its instructions call (bun and bunx). Our summary lists: Node.js.

Does Bun Win32 access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bun Win32 safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Bun Win32 use?

Bun Win32 is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bun Win32 use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.

What are the alternatives to Bun Win32?

Skills that share tags, products or a category with Bun Win32: OpenTUI Terminal Interfaces (cline/cline, 70k stars), holaOS App Builder SDK (holaboss-ai/holaOS, 11k stars), Web Artifacts Builder (anthropics/skills, 180k stars) and URL to Markdown Fetcher (JimLiu/baoyu-skills, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bun Win32?

involvex (a GitHub user) maintains it in involvex/youtube-music-cli, which has 456 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 8, 2026.

Source: involvex/youtube-music-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.