CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-typesafe

Use Typesafe Jev models with @ax-llm/ax in TypeScript. Covers boolean/class signatures with value descriptions, provider trueThreshold, native Noul/Choice/Score questions, structured criteria, probability-based decisions, and explicit hybrid generation.

64

Quality

80%

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 ./website/static/typescript/.well-known/agent-skills/ax-typesafe/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

82%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 an efficient, highly actionable reference for a niche provider integration: complete executable code, a clear interface-selection table, explicit constraints and failure modes, and well-signaled external references. Its only notable weaknesses are the absence of error-recovery feedback loops and the lack of any bundle files to offload reference-grade detail.

DimensionReasoningScore

Conciseness

The body is dense and provider-specific with essentially no explanation of concepts Claude already knows: the 'Choose the Interface' and transport tables, and bullets on question design all carry non-obvious information. It sits at level 4 rather than 5 because of minor trimmable redundancy, e.g., the API-key retrieval/throw boilerplate repeated verbatim in both code examples. It is clearly above level 3 since there is no padded or unnecessary explanatory prose.

4 / 5

Actionability

Two complete, copy-paste-ready TypeScript examples with imports, env-var handling, calls, and expected result shapes, plus four runnable 'npm run tsx' commands with the exact env keys each needs — fully executable and covering the common cases per the level-5 anchor. It is not level 4 because there are no meaningful gaps in the executable guidance.

5 / 5

Workflow Clarity

A clear selection path is provided ('Choose the Interface' decision table routing to signature, native, or hybrid approaches), with explicit failure modes and constraints ('fail before network access', 'if (!apiKey) throw', unsupported features enumerated) and a concrete hybrid composition pattern, matching level 4's clear sequence with most checkpoints present. It is not level 5 because there are no explicit validation/error-recovery feedback loops (e.g., how to handle validation failures or retry guidance), though the skill is a reference skill, not a destructive multi-step workflow, so the level-3 cap does not apply.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, and deep detail is delegated to clearly signaled one-level-deep external links (the signature skill for full syntax, provider docs for primitives and models, runnable example files), matching level 4's good structure with appropriately placed content. It is not level 5 because there are no bundle reference files to split the ~220-line body into, so some reference-grade material (full transport/settings details, question-design guidance) is inlined in SKILL.md itself; it is well above level 3 since nothing is buried and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

70%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 is specific and highly distinct, naming the exact SDK, model family, language, and primitives it covers. Its main weakness is the complete absence of any 'when to use this' trigger guidance, which caps completeness at 3, and its feature-listing 'Covers...' style rather than concrete action verbs.

Suggestions

Add an explicit trigger clause such as 'Use when integrating Typesafe/Jev decision primitives in TypeScript projects, or when the user mentions Typesafe, Jev, Noul, Choice, or Score questions' to raise completeness from 3.

Lead with action verbs instead of the passive 'Covers...' list (e.g., 'Build boolean/class signatures with value descriptions, send native Noul/Choice/Score questions, and compose explicit hybrid workflows') to move specificity from 4 to 5.

Include a couple of natural synonyms or alternate phrasings users might say (e.g., 'Ax framework', 'Typesafe SDK', 'deterministic classification') to broaden trigger term coverage.

DimensionReasoningScore

Specificity

The description enumerates several concrete capabilities ('boolean/class signatures with value descriptions, provider trueThreshold, native Noul/Choice/Score questions, structured criteria, probability-based decisions, and explicit hybrid generation'), which matches the level-4 anchor of several specific actions with minor gaps. It falls short of level 5 because 'Covers...' lists feature topics rather than the concrete action verbs exemplified by the top anchor, and well above level 3's 1-2 concrete actions.

4 / 5

Completeness

The 'what' is clear (use Typesafe Jev models with @ax-llm/ax in TypeScript, covering signatures, native questions, and hybrid generation), but there is no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. This matches the level-3 anchor exactly: clear what, when missing.

3 / 5

Trigger Term Quality

It includes the natural terms a user of this niche SDK would say — 'Typesafe Jev models', '@ax-llm/ax', 'TypeScript', 'Noul/Choice/Score' — giving good keyword coverage matching the level-4 anchor. Not level 5 because no synonyms, abbreviations, or alternative phrasings are offered beyond the canonical names.

4 / 5

Distinctiveness Conflict Risk

The description is tied to a single specific provider and SDK ('Typesafe Jev models with @ax-llm/ax') with distinct primitive names (Noul/Choice/Score), giving it a clear niche with minimal conflict risk, matching the level-5 anchor. It is not level 4 because there is no noticeable overlap with closely related skills.

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.