CtrlK
BlogDocsLog inGet started
Tessl Logo

add-lua-binding-api

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

56

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/add-lua-binding-api/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with concrete executable C++ examples and a clear step sequence, but it is monolithic with redundant examples and lacks build-validation checkpoints in the workflow.

Suggestions

Add an explicit compile/load validation step (e.g., build the project and load the binding in-game) with a fix-and-retry loop after registration.

Move per-domain API examples into separate reference files (e.g., references/game-api.md, references/map-api.md) and keep SKILL.md as a concise overview.

De-duplicate repeated examples (get_map, spawn_monster, fmt_lua_va) and trim the Logging and Common Patterns sections to reduce token cost.

DimensionReasoningScore

Conciseness

Largely lean code with no concept over-explanation, but redundant repeated examples (get_map shown three times, spawn_monster twice) and breadth sections like Logging/Common Patterns could be tightened.

2 / 3

Actionability

Extensive copy-paste-ready C++ examples with real signatures, luna::set_fx calls, DOC() macros, and error handling provide fully executable guidance.

3 / 3

Workflow Clarity

The create-extend-register sequence is clear, but the build/compile workflow lacks explicit validation checkpoints and a validate-fix-retry feedback loop, capping it at 2.

2 / 3

Progressive Disclosure

Sections are organized, but the ~430-line body is monolithic with no bundle reference files; per-domain content that should be split into separate files is inline.

2 / 3

Total

9

/

12

Passed

Description

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific and well-scoped to a distinct niche, clearly stating what it does, but it omits any explicit use-trigger guidance, capping completeness and limiting trigger-term quality.

Suggestions

Append an explicit trigger clause, e.g. "Use when adding or extending Cataclysm-BN Lua API bindings for game functions, utilities, constants, or callbacks."

Add common natural-language variations users might say (e.g. "Lua modding API", "expose C++ functions to Lua") to broaden trigger coverage.

Keep the concrete category list but pair it with the when-to-use framing to lift completeness to 3.

DimensionReasoningScore

Specificity

Enumerates multiple concrete binding categories ("global game functions, utility libraries, constants, callbacks, and domain-specific Lua namespaces"), matching the multiple-specific-actions anchor.

3 / 3

Completeness

Clearly states what the skill does but provides no "Use when..." trigger, so the when is missing rather than explicit.

2 / 3

Trigger Term Quality

Relevant domain keywords ("Lua API bindings", "game functions", "callbacks") are present but lack common conversational variations and explicit use-trigger phrasing.

2 / 3

Distinctiveness Conflict Risk

Tightly scoped to Cataclysm-BN Lua API bindings, a clear niche unlikely to conflict with other skills.

3 / 3

Total

10

/

12

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 14 missing, 7 suspicious

Warning

Total

14

/

16

Passed

Repository
cataclysmbn/Cataclysm-BN
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.