CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-java-typesafe

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

53

Quality

67%

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

Quality

Content

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

A well-organized, information-dense reference for a narrow library, with a usable core snippet and precise numeric rules. It is held back by an oversized inline API symbol dump, prose-only coverage of the native client and hybrid patterns, and a dense spec-style main section that buries operational guidance.

Suggestions

Move the "Relevant API Surface" symbol list into the referenced API docs (API.md/axir-api.json) and keep only the 5-8 most-used symbols inline, saving substantial context tokens.

Add short runnable snippets for the two other advertised use cases — the native client (system_one/list_models) and the two-program hybrid — since these are currently prose-only.

Break the "Typesafe / Jev" prose wall into labeled subsections or a step list (choose signature type -> set threshold -> forward -> verify probability constraints) so the constraints act as checkable validation points.

DimensionReasoningScore

Conciseness

The body is compact and assumes competence, but the "Relevant API Surface" section inlines a ~40-symbol comma-separated list ("Ax.s", "Ax.f", ... "MultiServiceRouter", "ProviderRouter") that duplicates the `API.md`/`axir-api.json` files already cited in Package Facts, and several spec sentences could be tightened ("this policy is local and never sent", "Ax never truncates or pretends to count native tokens exactly"). Not 4 because the inline API dump is a clearly trimmable token cost; not 2 because there is no padding explaining concepts Claude already knows.

3 / 5

Actionability

There is one executable snippet (Core Pattern) and concrete parameter rules ("Set provider trueThreshold (or true_threshold) to a finite value in [0,1], default 0.5"), but core features like the native client ("system_one / systemOne / SystemOne and list_models / listModels / ListModels"), balancers, and the two-program hybrid are described only in prose with no code or steps, deferring to src/examples/java/generation/. Not 4 because key common cases lack inline executable detail; not 2 because the core pattern plus precise numeric rules are genuinely concrete.

3 / 5

Workflow Clarity

"When To Use" gives clear selection rules ("Use Jev for typed decisions with ordinary Ax signatures", "Use native questions for probabilities..."), but the main "Typesafe / Jev" section is a dense prose wall with no sequencing, and operational guidance (e.g. validating that probabilities "sum to one within an inclusive 0.01 tolerance") is embedded mid-paragraph rather than presented as checkable steps. Not 4 because guidance for the core tasks is implicit in prose rather than sequenced; not 2 because the decision rules and guardrails do give a usable order of operations.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent), so scoring rests on the body: section headers are clear, and Package Facts signals API.md, axir-api.json, axir-capabilities.json, and examples/, but those files are not part of this bundle and the ~40-symbol API surface list is inline content that clearly belongs in a separate reference file. Not 2 because the structure is real and references are signaled in Package Facts; not 4 because content that should be separate is inlined and the referenced paths are not navigable bundle files.

3 / 5

Total

12

/

20

Passed

Description

71%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 distinct, well-targeted description with an explicit 'Use when...' trigger and an enumerated capability list. Its main weaknesses are jargon-heavy phrasing (Jev, Noul) that limits natural trigger-term coverage and a single narrow trigger situation.

Suggestions

Add user-natural synonyms to the trigger clause, e.g. "Use when writing Java with the Ax package (dev.axllm:ax), Ax Java SDK, or Typesafe/Jev signatures".

Broaden the when-clause to cover the main entry points named in the body, e.g. "...or when handling native Ax questions, scoring rubrics, or mixed typesafe/generation setups".

Soften or gloss the internal jargon (e.g. "Noul (probability threshold)") so the description reads as actions rather than opaque product terms.

DimensionReasoningScore

Specificity

The description enumerates several concrete capabilities — "Typesafe Jev boolean/class signatures, value descriptions, configurable Noul conversion, native Noul/Choice/Score, structured criteria and hybrid generation" — going well beyond naming the domain. It is not 5 because several of these terms are internal jargon whose actions are not self-explanatory, leaving minor coverage gaps; not 3 because multiple specific capabilities are clearly listed rather than only 1-2.

4 / 5

Completeness

Both parts are present: the "what" is the enumerated capability list, and the "when" is the explicit clause "Use when writing Java code with `dev.axllm:ax`". Not 5 because the when-clause covers only one trigger situation and could be more explicit; not 3 because the 'Use when...' clause is explicit and the what is concretely enumerated.

4 / 5

Trigger Term Quality

Relevant keywords exist ("Java code", "dev.axllm:ax") but the rest is internal jargon ("Jev", "Noul") that users would not naturally say, and common variations or synonyms of the natural triggers are missing. Not 4 because natural-phrase coverage is thin beyond the package coordinate; not 2 because it does include the domain-defining terms a user of this package would say.

3 / 5

Distinctiveness Conflict Risk

It carves a clear niche: Java plus the specific package coordinate `dev.axllm:ax` plus Typesafe Jev features, making it nearly unambiguous which skill should trigger and giving minimal overlap risk with other skills. Not 4 because the package identifier alone removes even minor conflict risk.

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.