CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-lua-binding-complex

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

Quality

75%

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-complex/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

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

An actionable, well-sequenced guide with executable code templates, explicit build/test validation, and strong troubleshooting coverage. Its weaknesses are length — generic conventions and pattern catalogs are inlined in the main file — and mild padding in sections that restate what the description or AGENTS.md already convey.

Suggestions

Move 'Advanced Patterns', 'Common Patterns Reference', and 'Coding Conventions' into a references/ file (e.g. references/advanced-patterns.md) and link them from a short SKILL.md overview.

Cut the 'Coding Conventions' section down to Cataclysm-BN/luna-specific conventions only, pointing to AGENTS.md for general C++23 style.

Trim the opening bullet list of features, which duplicates the frontmatter description without adding guidance.

DimensionReasoningScore

Conciseness

Mostly efficient with dense code, but the opening bullet list merely repeats the description and the 'Coding Conventions' section explains generic C++23 style (snake_case, designated initializers, ranges) that Claude already knows and that AGENTS.md already covers.

3 / 5

Actionability

Fully executable throughout: a complete copy-paste registration template, concrete build/format/test commands ('cmake --build --preset linux-full...', './out/build/linux-full/tests/cata_test-tiles "[lua]"'), and specific troubleshooting fixes keyed to exact error messages.

5 / 5

Workflow Clarity

A clear numbered 5-step sequence, a 'Files to Modify' checklist, explicit validation in 'Build and Verify', and a Troubleshooting section that serves as an error-recovery feedback loop (e.g. 'luna_traits<T>::impl is false' → add LUNA_DOC macro).

5 / 5

Progressive Disclosure

Section structure is good and the 'Reference Files' section clearly lists one-level-deep repo paths, but no bundle files exist and the ~365-line monolith inlines 'Advanced Patterns', 'Common Patterns Reference', and conventions that clearly belong in separate reference files.

3 / 5

Total

16

/

20

Passed

Description

63%Weight 40%Scale 1-5

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

A highly specific, well-scoped description that clearly communicates what the skill does in a distinct niche. Its main weakness is the complete absence of 'when to use' trigger guidance, and it misses several natural phrasings a user might employ.

Suggestions

Add an explicit trigger clause, e.g. 'Use when adding or extending Lua bindings for Cataclysm-BN C++ classes that need methods, inheritance, or custom operators.'

Include natural synonyms users would say, such as 'expose a C++ class to Lua' or 'wrap a class for the Lua API', to improve trigger matching.

Briefly state what distinguishes this from a simple binding skill (e.g. single-function vs. full-class exposure) to reduce overlap risk with a sibling skill.

DimensionReasoningScore

Specificity

Enumerates six concrete capabilities — 'methods, inheritance, constructors, properties, operators, and ownership rules' — within a precisely named domain (Cataclysm-BN Lua bindings for complex C++ classes), giving comprehensive coverage with no gaps.

5 / 5

Completeness

The 'what' is clearly and specifically stated, but there is no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines.

3 / 5

Trigger Term Quality

Relevant keywords like 'Lua bindings', 'Cataclysm-BN', and 'C++ classes' are present, but common natural variations users would say — 'expose to Lua', 'wrap a class', 'sol2' — are missing.

3 / 5

Distinctiveness Conflict Risk

The Cataclysm-BN Lua binding niche is highly distinct with minimal conflict risk, though the 'complex' qualifier implies a sibling simple-binding skill with which minor overlap risk exists.

4 / 5

Total

15

/

20

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 8 missing

Warning

Total

14

/

16

Passed

Repository

cataclysmbn/Cataclysm-BN

Path

.agents/skills/add-lua-binding-complex/SKILL.md

Revision

9d4abdd

Reviewed

Table of Contents

DiscoveryImplementationValidation

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.

Claim skill