CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-gepa

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for GEPA, Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts.

56

Quality

71%

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

Quality

Content

57%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-sectioned body that stays on package-specific ground and avoids over-explanation. It is weakened by a non-executable core snippet with inconsistent package qualifiers, the absence of an ordered workflow, and references to detail files that are not part of the bundle.

Suggestions

Make the Core Pattern copy-paste ready: include the import path, construction of the reflection client and evaluator, and unify the 'ax.' vs 'axllm.' package qualifiers used across the snippet and the API surface list.

Add a short numbered workflow for the primary tasks (e.g., 1. pick a no-key or provider example from examples/, 2. construct the engine, 3. run Optimize, 4. inspect the Pareto front from the result) with a checkpoint for verifying the run.

Bundle the referenced files (API.md, axir-api.json, axir-capabilities.json, examples/) or state their actual location, so the signaled references resolve instead of dead-ending.

DimensionReasoningScore

Conciseness

The body is lean and almost entirely package-specific facts Claude would not know (runtime profiles, no-key transport, capability manifest). Minor trimmable redundancy keeps it below anchor 5: the intro sentence restates the frontmatter description, and 'Language: Go' is trivially inferable from the package path.

4 / 5

Actionability

The 'Core Pattern' snippet ('engine := ax.NewGEPA(reflectionClient, nil); result := engine.Optimize(request, evaluator)') has unbound variables, no imports, and no evaluator construction — closer to executable-shaped pseudocode than copy-paste code. It also mixes the 'ax.' and 'axllm.' package qualifiers, and the guardrail 'Start from package examples' delegates to an examples/ directory that is not present in the bundle, matching anchor 3 (some concrete guidance but incomplete) rather than anchor 4.

3 / 5

Workflow Clarity

There is no step sequence for accomplishing the core tasks (run the optimizer, inspect an artifact); the only sequencing hint is 'Use BootstrapFewShot before GEPA when demonstrations should seed optimization'. The skill is not destructive/batch so no validation cap applies, but the 'When To Use' bullets leave the sequence implicit, fitting anchor 3 (steps implicit, checkpoints missing) better than anchor 4's clear sequence.

3 / 5

Progressive Disclosure

Sections are well organized and references are clearly signaled ('Package API docs: `API.md` and `axir-api.json`', 'Runnable examples: `examples/`'), but none of the referenced files — API.md, axir-api.json, axir-capabilities.json, or examples/ — exist in the skill bundle, so the navigation layer dead-ends. This sits between anchor 2 (broken/minimal structure) and anchor 4 (references mostly clear and usable): the in-file structure is good, but the deferred detail material is absent.

3 / 5

Total

13

/

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.

A well-targeted, appropriately concise description with an explicit trigger clause and a distinct niche. Its main weakness is that the capability list reads as topics rather than actions, and common trigger synonyms are missing.

Suggestions

Rewrite the capability list with action verbs, e.g., 'Run the GEPA optimizer, track metric budgets and reflection calls, inspect Pareto fronts and optimizer state, and work with BootstrapFewShot seeding'.

Add natural trigger synonyms users might say, such as 'prompt optimization', 'evolutionary optimizer', or 'ax'.

DimensionReasoningScore

Specificity

The description names a precise domain ('writing Go code with `github.com/ax-llm/ax/packages/go`') and several concrete capability topics ('GEPA, Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts'), but the only action verb is the generic 'writing'. It sits between anchor 2 (actions minimal or generic) and anchor 4 (several specific actions): the capability list is concrete, yet the items are noun-phrase topics rather than actions like 'run', 'track', or 'inspect'.

3 / 5

Completeness

An explicit 'Use when writing Go code with...' clause clearly answers 'when', and the 'what' is present (writing Go code with this package for those capability areas). It is not a 5 because the 'what' is a single generic action merged into the when-clause rather than a distinct list of concrete capabilities; it is above anchor 3 because both elements are explicitly stated.

4 / 5

Trigger Term Quality

Terms like 'GEPA', 'Pareto tradeoffs', 'reflection clients', 'metric budgets', 'optimizer state', plus the full package path, are natural phrases a user of this niche package would say, giving good coverage. It falls short of anchor 5 because common variations are missing (e.g., 'prompt optimization', 'BootstrapFewShot', 'ax', 'candidate evaluation') and it is above anchor 3 since the included terms are specific rather than generic.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to one specific generated package path with niche GEPA/Pareto terminology, forming a clear niche with distinct triggers and minimal conflict risk with other skills. No neighboring anchor fits better.

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.