Agent skill

Add Lua Binding Simple

by cataclysmbn in cataclysmbn/Cataclysm-BN

Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types.

Custom licenceAuto-check passed

Install Add Lua Binding Simple

skills CLI
$ npx skills add cataclysmbn/Cataclysm-BN --skill add-lua-binding-simple -a claude-code

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

GitHub CLI
$ gh skill install cataclysmbn/Cataclysm-BN add-lua-binding-simple --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/cataclysmbn/Cataclysm-BN.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/add-lua-binding-simple .claude/skills/add-lua-binding-simple && 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
add-lua-binding-simple
GitHub stars
1.3k
Token cost
~846 tokens
SKILL.md length
208 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Custom licence

At a glance

Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types.

  • Works in 5 steps: Identify the type you want to bind… → Choose the binding file (usually… → Add Luna documentation macro to… → …
  • Exposing straightforward C++ types to Lua
  • SKILL.md covers What You'll Do, Step-by-Step Instructions, Important Patterns and Testing, plus 3 more sections
  • Calls cmake

What it does

Add Lua Binding Simple is an agent skill from cataclysmbn/Cataclysm-BN. Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types. Use when exposing straightforward C++ types to Lua.

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

It works with Lua and C++. The repository describes itself as: Cataclysm: Bright Nights: A fork/variant of Cataclysm:DDA by CleverRaven with a mod registry at https://mods.cataclysmbn.org/.

When your agent uses it

  • Exposing straightforward C++ types to Lua

Example prompts

  • “/add-lua-binding-simple”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Identify the type you want to bind (e.g., my_type, my_enum)
  2. Choose the binding file (usually src/catalua_bindings_ids.cpp for IDs, or a relevant catalua_bindings_*.cpp)
  3. Add Luna documentation macro to src/catalua_luna_doc.h
  4. Register the binding in the appropriate function
  5. Build and test the changes

What it can do on your machine

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

    Shell commands in SKILL.md call:

    • cmake

    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

Add Lua Binding Simple loads about 846 tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 208 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 208 words (~846 tokens).

“This skill helps you add Lua bindings for simple C++ types like string_id, enums, or basic classes.”

— opening of SKILL.md by cataclysmbn, Custom licence
name
add-lua-binding-simple
metadata.argument-hint
TypeName [output-file]

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/add-lua-binding-simple of cataclysmbn/Cataclysm-BN.

Open the folder on GitHubat commit adb112c

Compare with similar skills

Add Lua Binding Simple 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.

Add Lua Binding Simple compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Lua Binding Simple this skillcataclysmbn/Cataclysm-BN1.3k—~846Automated safety check: PassCustom licence
Cpp Compiler FlagsSerial-Studio/Serial-Studio7.2k—~2.1kAutomated safety check: PassCustom licence
Luamakeactboy168/luamake210—~2kAutomated safety check: PassMIT
Ss Cpp ModernSerial-Studio/Serial-Studio7.2k—~1.6kAutomated safety check: PassCustom licence
Bee Luaactboy168/bee.lua194—~613Automated safety check: PassMIT
Elodin DBelodin-sys/elodin547—~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • 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 today
    DevelopmentAuto-check passed
  • Luamake

    actboy168/luamake

    Luamake 构建系统指南——用于当前项目的 luamake / make.lua / Ninja 生成流程。当用户需要编写、修改、排查或理解 make.lua、目标定义、lm:conf、deps / objdeps、代码生成、Lua C 模块、Bee 运行时集成,或需要解决当前项目中由 luamake 驱动的构建问题时,使用此 skill。即使用户没有明确提到…

    210 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check passed
  • Ss Cpp Modern

    Serial-Studio/Serial-Studio

    Modern C++20 authoring guidance for Serial Studio (Qt 6.11, C++20): concepts, ranges, move/RAII, std smart pointers, constexpr, lock-free SPSC atomics.

    7.2k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Bee Lua

    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…

    194 GitHub stars~613 tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Elodin DB

    elodin-sys/elodin

    Work with Elodin-DB, the time-series telemetry database. An agent skill from elodin-sys/elodin.

    547 GitHub stars~2.8k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Defold Native Extension Editing

    selimanac/defold-astar

    Defold native extension development. An agent skill from selimanac/defold-astar.

    111 GitHub stars~2.1k tokensUpdated 5 mo ago
    DevelopmentAuto-check passed

More from cataclysmbn/Cataclysm-BN

All 11 skills in this repo
  • Deno Script

    cataclysmbn/Cataclysm-BN

    Write or modify Cataclysm-BN Deno/TypeScript scripts. An agent skill from cataclysmbn/Cataclysm-BN.

    1.3k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Add Lua Binding API

    cataclysmbn/Cataclysm-BN

    Add Cataclysm-BN Lua API bindings for global game functions, utility libraries, constants, callbacks, and domain-specific Lua namespaces.

    1.3k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Add Lua Binding Complex

    cataclysmbn/Cataclysm-BN

    Add comprehensive Cataclysm-BN Lua bindings for complex C++ classes with methods, inheritance, constructors, properties, operators, and ownership rules.

    1.3k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Changelog Gen

    cataclysmbn/Cataclysm-BN

    Rewrite every docs//game/changelog/{order}.stable-{semver}.md from a ref range.

    1.3k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Lua Binding Reference

    cataclysmbn/Cataclysm-BN

    Quick reference for Cataclysm-BN Lua binding macros, Luna usertypes, libraries, documentation, type patterns, build steps, and common errors.

    1.3k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Translate

    cataclysmbn/Cataclysm-BN

    Add the remaining English, Korean, and Japanese translations for documentation files added since main.

    1.3k GitHub stars~480 tokensUpdated today
    Auto-check passed

Works with

Questions about Add Lua Binding Simple

What does Add Lua Binding Simple do?

Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types. Add Lua Binding Simple is an agent skill from cataclysmbn/Cataclysm-BN. Add simple Cataclysm-BN Lua bindings for stringid types, enums, and basic read-only C++ types.

When should I use Add Lua Binding Simple?

Add Lua Binding Simple fits situations like: exposing straightforward C++ types to Lua.

How do I install Add Lua Binding Simple in Claude Code?

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

How do I install Add Lua Binding Simple in Codex?

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

Can I use Add Lua Binding Simple 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 cataclysmbn/Cataclysm-BN --skill add-lua-binding-simple -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-lua-binding-simple, .gemini/skills/add-lua-binding-simple, .github/skills/add-lua-binding-simple and .opencode/skills/add-lua-binding-simple in your project.

What does Add Lua Binding Simple need to run?

Going by SKILL.md and its folder, Add Lua Binding Simple needs the command-line tools its instructions call (cmake).

Does Add Lua Binding Simple 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 Add Lua Binding Simple 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 Add Lua Binding Simple use?

Add Lua Binding Simple has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Add Lua Binding Simple use?

About 846 tokens (SKILL.md is roughly 3.4k 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 Add Lua Binding Simple?

Skills that share tags, products or a category with Add Lua Binding Simple: Cpp Compiler Flags (Serial-Studio/Serial-Studio, 7.2k stars), Luamake (actboy168/luamake, 210 stars), Ss Cpp Modern (Serial-Studio/Serial-Studio, 7.2k stars) and Bee Lua (actboy168/bee.lua, 194 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Lua Binding Simple?

cataclysmbn (a GitHub organization) maintains it in cataclysmbn/Cataclysm-BN, which has 1,257 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: cataclysmbn/Cataclysm-BN on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.