CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-java-refine

Use when writing Java code with `dev.axllm:ax` for reward-scored generation, iterative candidate improvement, evaluator feedback, and optimizer-backed refinement patterns.

65

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 tight, well-organized reference body: a concrete call-shape example, a named API surface, package-specific facts Claude cannot infer, and actionable guardrails, with clearly signaled pointers to the package's docs and examples. Its only notable gap is that the Core Pattern snippet is a call shape rather than a complete runnable example, which the body itself mitigates by directing to the package examples.

DimensionReasoningScore

Conciseness

The body is mostly lean bullet lists, a two-line code snippet, and domain-specific guardrails that Claude cannot know (runtime profiles, transport support). Minor trimming is possible — 'Language: Java' restates the title and 'Package: dev.axllm:ax' repeats the frontmatter and intro sentence — which fits anchor 4 ('efficient; minor instances of over-explanation') rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

The Core Pattern gives real Java syntax ('new AxGEPA(reflectionClient, java.util.Map.of())', 'engine.optimize(request, evaluator)') and the Relevant API Surface names concrete classes, plus a pointer to runnable examples. It falls short of anchor 5 because the snippet depends on undefined locals and lacks imports (not copy-paste ready), but it is well above anchor 3's pseudocode profile.

4 / 5

Workflow Clarity

This is a single-purpose reference skill with no destructive or batch operations, so no validation loop is required. The path (When To Use → Core Pattern → API surface → Guardrails, starting from package examples) is unambiguous, and the Guardrails section supplies implicit checkpoints (provider-api only with credentials, no-key for local checks). It is not a 5 because the guidance is never explicitly sequenced as steps.

4 / 5

Progressive Disclosure

The body is under 50 lines, no bundle files exist to disclose, and sections are well-organized with external materials (API.md, axir-api.json, axir-capabilities.json, examples/) clearly signaled one level deep under Package Facts. This matches the rubric's simple-skill exception where well-organized sections alone warrant a 5.

5 / 5

Total

17

/

20

Passed

Description

78%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 strong, third-person description with an explicit 'Use when' trigger scoped to a specific package and language, listing multiple concrete capabilities. Its main weaknesses are the fused what/when phrasing and pattern-label vocabulary that omits a few natural synonyms users might say.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — 'reward-scored generation', 'iterative candidate improvement', 'evaluator feedback', 'optimizer-backed refinement patterns' — but these read as pattern labels rather than fully concrete actions, and coverage is not comprehensive (caching, globals, and playbook surfaces appear only in the body). This matches anchor 4 ('several specific actions; minor gaps') better than anchor 5, and is clearly above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The explicit 'Use when writing Java code with dev.axllm:ax for...' clause answers 'when' clearly, and the embedded capability list answers 'what'. However, the 'what' is fused into the 'when' clause rather than stated as its own explicit statement of what the skill provides (API patterns, examples, guardrails), so it falls short of anchor 5's fully separated and concretely-triggered form while exceeding anchor 3 (where 'when' is missing or weakly implied).

4 / 5

Trigger Term Quality

Natural terms for this audience are present: 'Java', 'dev.axllm:ax', 'evaluator feedback', 'refinement', 'optimizer'. A few natural variations are missing (e.g. 'improve outputs', 'prompt optimization', 'GEPA', bare 'Ax'), which fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 3's missing-variations profile or anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to one named package ('dev.axllm:ax') and one language ('Java'), giving it a clear niche with distinct triggers and minimal conflict risk with other skills — a direct match for anchor 5.

5 / 5

Total

17

/

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.