CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-cpp-typesafe

Use when writing C++ code with `axllm` for Typesafe Jev boolean/class signatures, value descriptions, configurable Noul conversion, native Noul/Choice/Score, structured criteria and hybrid generation.

59

Quality

74%

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 ./packages/cpp/skills/ax-cpp-typesafe/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is a dense, fact-rich reference with an executable core code example, precise numeric constraints, and clear decision routing between the typesafe, native, and hybrid paths. Its weaknesses are the inline ~35-symbol API inventory, prose-only treatment of the native client and Score/Choice usage, and the absence of any reference files in the bundle despite material that would split well.

Suggestions

Move the "Relevant API Surface" symbol list into a reference file (e.g., references/api-surface.md) and keep only the handful of symbols needed for the core pattern in SKILL.md.

Add one short executable snippet for the native client (system_one / Score / Choice criteria) mirroring the Core Pattern, since that path is currently prose-only.

Collapse the triple-convention method naming ("system_one / systemOne / SystemOne") to a single canonical form with a one-line note that camelCase/PascalCase aliases exist.

DimensionReasoningScore

Conciseness

The body contains no padding about concepts Claude already knows — it is dense, package-specific fact throughout — but the flat ~35-symbol "Relevant API Surface" list and the repeated triple-convention naming ("system_one / systemOne / SystemOne", "describe_values / describeValues / DescribeValues") are bulk that could be tightened or trimmed. This is more than the 'minor instances' of anchor 4, though well short of anchor 2's padded explanations.

3 / 5

Actionability

The Core Pattern is real, executable C++ covering model construction, a signature with boolean/class criteria descriptions, and a forward call, and the constraint guidance is exact (trueThreshold in [0,1] default 0.5, 0.01 inclusive tolerance, 1–255 Choice labels, 2–10 Score levels). It falls short of anchor 5 because the native client (system_one/list_models), Score/Choice criteria syntax, and the hybrid two-program pattern are discussed only in prose with no code.

4 / 5

Workflow Clarity

Decision routing is clear ("Use Jev for typed decisions…", "Use native questions for probabilities…", "Compose a separate generative program for prose or tools") and the Guardrails section gives concrete ordering advice ("Start from package examples for exact native syntax"). No validation checkpoints exist, but there are no destructive or batch operations to validate; the hybrid path is delegated entirely to an external examples link, a minor gap that keeps it below 5.

4 / 5

Progressive Disclosure

Section organization is good and Package Facts clearly signals where the package docs live ("API.md", "axir-api.json", "examples/"), but the long inline "Relevant API Surface" symbol dump is content that belongs in a separate reference file, and the bundle ships no reference files at all despite clearly splittable material. This matches anchor 3 ('content that should be separate is inline'), short of anchor 4's appropriately-placed bulk content.

3 / 5

Total

14

/

20

Passed

Description

73%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.

The description has a strong, explicit trigger clause and covers a distinctive, well-demarcated niche with good domain keyword coverage. Its main weakness is that the capability list is a jargon-heavy noun inventory with no stated actions, leaving the 'what' implied rather than explicit.

Suggestions

State at least one concrete action the skill performs (e.g., "Guides writing of typesafe Jev boolean/class signatures with the axllm C++ API") instead of relying purely on a noun-phrase feature list.

Trim or briefly gloss project-specific jargon ("Noul", "Typesafe Jev") so the description communicates capabilities to a reader who knows the package less intimately.

Add one or two natural synonyms or phrasing variations (e.g., "scoring", "typed decisions") to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

The description names the domain ("C++ code with `axllm`") and enumerates concrete capability areas ("Typesafe Jev boolean/class signatures, value descriptions, configurable Noul conversion, native Noul/Choice/Score, structured criteria and hybrid generation"), but these are all jargon noun-phrases with no action verbs, so it never states what the skill actually does. It is more specific than anchor 2 (domain-only) but lacks the 'several specific actions' required by anchor 4.

3 / 5

Completeness

The 'when' is explicit and concrete ("Use when writing C++ code with `axllm`"), and the 'what' is conveyed through the feature list, but the skill's actual function (guiding API usage for these features) is only implied by the prepositional enumeration rather than stated as a clear action. Not the fully explicit what+when pairing of anchor 5, but clearly above anchor 3's weakly-implied 'when'.

4 / 5

Trigger Term Quality

Good keyword coverage of natural domain terms: "C++", "axllm", "typesafe", "Jev", "boolean", "class", "Noul", "Choice", "Score", "criteria", and "hybrid generation" — the vocabulary a user of this package would naturally say. It falls short of anchor 5 because common variations and synonyms (e.g., "type-safe", "scoring", "evaluation") are absent.

4 / 5

Distinctiveness Conflict Risk

"C++ code with `axllm`" combined with niche markers like "Typesafe Jev" and "Noul" defines a clear, narrow specialization with distinct triggers and minimal overlap risk with any generic skill.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
ax-llm/ax
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.