Agent skill

Bee Lua

by actboy168 in actboy168/bee.lua

bee.lua 运行时库指南——Lua 5.4/5.5 上的跨平台系统级绑定(异步 I/O、网络、子进程、线程、文件系统、文件监控、崩溃 dump)。当需要在本项目里编写、修改或排查使用 require "bee." 的 Lua 代码,涉及 socket/select/epoll/async、thread/channel/serialization、subprocess、filesystem/f…

MITAuto-check passedDevelopment

Install Bee Lua

skills CLI
$ npx skills add actboy168/bee.lua --skill bee-lua -a claude-code

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

GitHub CLI
$ gh skill install actboy168/bee.lua bee-lua --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/actboy168/bee.lua.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills .claude/skills/bee-lua && 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
bee-lua
GitHub stars
194
Token cost
~613 tokens
SKILL.md length
151 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

bee.lua 运行时库指南——Lua 5.4/5.5 上的跨平台系统级绑定(异步 I/O、网络、子进程、线程、文件系统、文件监控、崩溃 dump)。当需要在本项目里编写、修改或排查使用 require "bee." 的 Lua 代码,涉及 socket/select/epoll/async、thread/channel/serialization、subprocess、filesystem/f…

  • Tasks that involve Debugging
  • SKILL.md covers API 参考来源, 模块索引, 跨模块约定 and 可选链(编译期 patch)
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bee Lua is an agent skill from actboy168/bee.lua. bee.lua 运行时库指南——Lua 5.4/5.5 上的跨平台系统级绑定(异步 I/O、网络、子进程、线程、文件系统、文件监控、崩溃 dump)。当需要在本项目里编写、修改或排查使用 require "bee." 的 Lua 代码,涉及 socket/select/epoll/async、thread/channel/serialization、subprocess、filesystem/filewatch、time/sys/crash/debugging/windows,或需要按平台差异处理行为时,使用本 skill。即使用户没有明确提到 bee.lua,只要上下文是在调用 bee 命名空间下的模块,也应使用。不要用于纯 Lua 语言/标准库问题、与 bee 无关的第三方 C 模块,或本项目 C++ 层 bee/、binding/ 的实现细节(那些看源码)。

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Debugging. It works with Lua and C++. The repository describes itself as: Lua runtime and toolset. The licence is MIT.

When your agent uses it

  • Tasks that involve Debugging

Example prompts

  • “/bee-lua”

What it can do on your machine

Read from SKILL.md and the folder at commit a7198d4. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Bee Lua loads about 613 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 151 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~613

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from actboy168/bee.lua at commit a7198d4, republished under its MIT licence (© actboy168). 151 words, ~613 tokens.

Download SKILL.mdSave it as .claude/skills/bee-lua/SKILL.md (or your agent's skills folder).
name
bee-lua
description
bee.lua 运行时库指南——Lua 5.4/5.5 上的跨平台系统级绑定(异步 I/O、网络、子进程、线程、文件系统、文件监控、崩溃 dump)。当需要在本项目里编写、修改或排查使用 `require "bee.*"` 的 Lua 代码,涉及 socket/select/epoll/async、thread/channel/serialization、subprocess、filesystem/filewatch、time/sys/crash/debugging/windows,或需要按平台差异处理行为时,使用本 skill。即使用户没有明确提到 bee.lua,只要上下文是在调用 `bee` 命名空间下的模块,也应使用。不要用于纯 Lua 语言/标准库问题、与 bee 无关的第三方 C 模块,或本项目 C++ 层 `bee/`、`binding/` 的实现细节(那些看源码)。

bee.lua

Lua 扩展库,为 Lua 5.4 / 5.5 提供系统级原生绑定。

API 参考来源

本 skill 不维护 bee 的 API 签名表,以仓库里的文件为唯一权威来源:

目的来源
函数签名、参数/返回值类型、字段与常量meta/<module>.lua(LuaLS/EmmyLua 注解,带中文说明)
行为契约、错误文案、边界情况、可运行示例test/test_<module>.lua
构建与测试命令、测试规范AGENT.md
C++ 层实现细节bee/、binding/lua_<module>.cpp

模块索引

模块meta用途
bee.platformmeta/platform.lua平台/编译器/架构信息(纯数据表)
bee.filesystemmeta/filesystem.lua路径与文件系统操作
bee.serializationmeta/serialization.lua序列化(线程/通道的底层)
bee.timemeta/time.lua墙钟 / 单调 / 线程 CPU 时间
bee.sysmeta/sys.lua可执行文件路径、文件锁
bee.socketmeta/socket.luaTCP/UDP/Unix socket
bee.selectmeta/select.luaselect 风格多路复用
bee.epollmeta/epoll.luaepoll 风格多路复用(Windows 走 IOCP)
bee.asyncmeta/async.lua异步 I/O(IOCP / io_uring / GCD)
bee.filewatchmeta/filewatch.lua文件监控
bee.threadmeta/thread.lua线程
bee.channelmeta/channel.lua线程间通信
bee.subprocessmeta/subprocess.lua子进程与管道
bee.windowsmeta/windows.luaWindows 专有工具
bee.crashmeta/crash.lua崩溃 dump
bee.debuggingmeta/debugging.lua断点 / 调试器探测

跨模块约定

  • 模块都在 bee.* 命名空间:local socket = require "bee.socket"。
  • 三态返回值(socket / epoll / select 等非阻塞接口):成功 → 值;false → 需等待(非错误);nil, errmsg → 失败/对端关闭。参数校验错误才 error()。
  • 句柄类对象用 to-be-closed 管理:local fd <close> = assert(socket.create "tcp")。
  • 子进程管道是标准 file*,用 :read "a" / :write / :close。
  • 线程/通道传值经 bee.serialization,只支持 nil/boolean/number/string/table/light C function。
  • 平台上不可用的模块/接口在测试中跳过(test/test_skip.lua、test/supported.lua)。

可选链(编译期 patch)

?. / ?: / ?[...] / f?(...) 是 vendored Lua 的补丁语法,仅当 luamake -optchain 构建时可用(补丁机制见 AGENT.md):

  • 只有 nil 短路,false 会照常报错;短路时参数/键不会被求值,接收者只求值一次。
  • 短路只覆盖链本身:(nothing?.b).c、nothing?.b + 1 仍报错。
  • 不可作为赋值目标。
  • 完整行为(含字节码布局)见 test/test_optional_chain.lua。

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

Files

Just SKILL.md in skills of actboy168/bee.lua.

Open the folder on GitHubat commit a7198d4

Compare with similar skills

Bee Lua 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.

Bee Lua compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bee Lua this skillactboy168/bee.lua194—~613Automated safety check: PassMIT
Extempore JIT Debugging Guidedigego/extempore1.5k—~4.4kAutomated safety check: PassNone
OpenROAD Bug FixerThe-OpenROAD-Project/OpenROAD3.2k—~784Automated safety check: PassBSD-3-Clause
Cppcrazyguitar/cppcheatsheet290—~1.8kAutomated safety check: PassMIT
MCP Debuggerdebugmcp/mcp-debugger171—~3.8kAutomated safety check: PassMIT
Cpp Compiler FlagsSerial-Studio/Serial-Studio7.2k—~2.1kAutomated safety check: PassCustom licence

Similar skills

  • Debugging guide for Extempore covering its three layers, compilation paths, startup sequence and the batch, eval and interactive modes used to isolate JIT problems.

    1.5k GitHub stars~4.4k tokensUpdated 13 days ago
    DevelopmentAuto-check passed
  • OpenROAD Bug Fixer

    The-OpenROAD-Project/OpenROAD

    Fixes an OpenROAD bug from a GitHub issue or error code: finds the root cause, implements the fix, adds a regression test and prepares a signed-off commit.

    3.2k GitHub stars~784 tokensUpdated today
    DevelopmentAuto-check passed
  • Cpp

    crazyguitar/cppcheatsheet

    Comprehensive C/C++ programming reference covering everything from C11-C23 and C++11-C++23, system programming, CUDA GPU computing, debugging tools, Rust interop, and advanced topics.

    290 GitHub stars~1.8k tokensUpdated 6 days ago
    DevelopmentAuto-check passed
  • MCP Debugger

    debugmcp/mcp-debugger

    A skill your agent uses when investigating a bug, failing test, or unexpected runtime behavior and the mcp-debugger MCP server is available — drives real step-through debuggers (breakpoints, stack…

    171 GitHub stars~3.8k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cpp Compiler Flags

    Serial-Studio/Serial-Studio

    C++ compiler/linker flag guidance for Serial Studio's build (GCC, Clang, AppleClang, MSVC cl.exe, clang-cl, MinGW, IntelLLVM).

    7.2k GitHub stars~2.1k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Dbg

    theodo-group/debug-that

    Debug applications using the dbg CLI debugger. An agent skill from theodo-group/debug-that.

    158 GitHub stars~1.9k tokensUpdated 4 mo ago
    DevelopmentAuto-check passed

Works with

Categories

Questions about Bee Lua

What does Bee Lua do?

bee.lua 运行时库指南——Lua 5.4/5.5 上的跨平台系统级绑定(异步 I/O、网络、子进程、线程、文件系统、文件监控、崩溃 dump)。当需要在本项目里编写、修改或排查使用 require "bee." 的 Lua 代码,涉及 socket/select/epoll/async、thread/channel/serialization、subprocess、filesystem/f…. lua.

When should I use Bee Lua?

Bee Lua fits situations like: tasks that involve Debugging.

How do I install Bee Lua in Claude Code?

Run `npx skills add actboy168/bee.lua --skill bee-lua -a claude-code`. Or copy the skill folder (skills in actboy168/bee.lua) into .claude/skills/bee-lua in your project. Claude Code loads it when a task matches its description.

How do I install Bee Lua in Codex?

Run `npx skills add actboy168/bee.lua --skill bee-lua -a codex`. Or copy the skill folder (skills in actboy168/bee.lua) into .agents/skills/bee-lua in your project. Codex loads it when a task matches its description.

Can I use Bee Lua 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 actboy168/bee.lua --skill bee-lua -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bee-lua, .gemini/skills/bee-lua, .github/skills/bee-lua and .opencode/skills/bee-lua in your project.

What does Bee Lua need to run?

SKILL.md names no scripts, command-line tools or credentials: Bee Lua is instructions for the agent only.

Does Bee Lua 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 Bee Lua 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. Review the folder before installing.

What licence does Bee Lua use?

Bee Lua 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 Bee Lua use?

About 613 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bee Lua?

Skills that share tags, products or a category with Bee Lua: Extempore JIT Debugging Guide (digego/extempore, 1.5k stars), OpenROAD Bug Fixer (The-OpenROAD-Project/OpenROAD, 3.2k stars), Cpp (crazyguitar/cppcheatsheet, 290 stars) and MCP Debugger (debugmcp/mcp-debugger, 171 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bee Lua?

actboy168 (a GitHub user) maintains it in actboy168/bee.lua, which has 194 GitHub stars. The repository was last updated on September 29, 2026.

Source: actboy168/bee.lua on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.