CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ax-java-agent-context

Use when writing Java code with `dev.axllm:ax` for deciding between context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall for long-context agents.

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 ./packages/java/skills/ax-java-agent-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 concise, well-organized routing skill with a good executable core pattern and useful guardrails. Its weakness is that the central decision the skill exists to make — choosing between contextMap, contextPolicy, optimization, and recall — has no criteria, examples, or per-feature code, so the agent is left to infer the routing logic.

Suggestions

Add a short decision table or criteria list under 'When To Use' showing when to choose contextMap vs contextPolicy vs optimization (ACE/GEPA) vs memory recall, e.g. signal phrases or task shapes that map to each feature.

Include one-line code snippets or example entry points for each of the four features (contextMap, contextPolicy, Ax.optimize/Ax.playbook, and recall), mirroring the existing Core Pattern style.

Clarify where the referenced artifacts live (e.g. note that 'API.md', 'axir-capabilities.json', and 'examples/' ship inside the dev.axllm:ax package distribution) or add them to a references/ bundle so the paths are resolvable from the skill.

DimensionReasoningScore

Conciseness

The body is lean and efficient: terse bullet facts ('Real network support: yes'), one compact code snippet, and guardrails with no explanation of concepts Claude already knows. Every line adds package-specific information, matching the 'every token earns its place' anchor.

5 / 5

Actionability

There is one concrete executable snippet ('AxAgent helper = Ax.agent("question:string -> answer:string", java.util.Map.of())') plus named API symbols, but the skill's core purpose — deciding between contextMap, contextPolicy, optimization, and recall — has no code, criteria, or per-feature examples. This is incomplete concrete guidance rather than the mostly-executable coverage of a 4.

3 / 5

Workflow Clarity

Orientation sections exist (When To Use, Package Facts, Core Pattern, Guardrails) but there is no selection procedure or criteria for choosing among the four context features the skill is named for, leaving the primary action ambiguous. No destructive/batch operations are involved so no validation cap applies, but sequence/checkpoint clarity is only implicit.

3 / 5

Progressive Disclosure

The body is short and cleanly sectioned, and references ('API.md', 'axir-api.json', 'examples/') are clearly signaled as package artifacts. It does not reach 5 because those referenced paths are not present in the skill bundle (no references/, scripts/, or assets/ directories exist), so navigation cannot be fully resolved from the skill itself.

4 / 5

Total

15

/

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 solid, well-scoped description that explicitly states both what it does and when to use it, anchored to a specific package. Its main weakness is trigger phrasing dominated by package-specific jargon ('trajectory context policy', 'ACE/GEPA') rather than terms a user would naturally say, which limits discoverability.

DimensionReasoningScore

Specificity

The description names the domain ('writing Java code with `dev.axllm:ax`') and four concrete decision targets ('context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall'), giving several specific capabilities. It falls short of a 5 because these are framed as decision points rather than multiple concrete executable actions, leaving minor coverage gaps.

4 / 5

Completeness

Both elements are present: an explicit trigger ('Use when writing Java code with `dev.axllm:ax`') and an explicit what ('for deciding between context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall'). The 'when' is explicit but the 'what' is embedded inside the trigger clause rather than stated as its own capability statement, so it does not clearly merit a 5.

4 / 5

Trigger Term Quality

Some natural keywords are present ('Java code', 'optimization', 'memory recall', 'long-context agents'), but terms like 'trajectory context policy' and 'ACE/GEPA' are package jargon users would not naturally say, and common variations such as 'Ax', 'context policy', or 'recall' phrasings are missing. It does not reach 4 because the natural-phrase coverage is thin relative to the technical vocabulary.

3 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to a specific generated Java package ('dev.axllm:ax') with feature-specific triggers (context maps, ACE/GEPA, memory recall), giving it a clear niche with minimal risk of firing for unrelated Java or memory 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

Path

packages/java/skills/ax-java-agent-context/SKILL.md

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.