CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ax-gepa

This skill helps an LLM generate correct AxGEPA optimization code using @ax-llm/ax. Use when the user asks about AxGEPA, GEPA, Pareto optimization, multi-objective prompt tuning, reflective prompt evolution, validationExamples, maxMetricCalls, or optimizing a generator, flow, or agent tree.

Quality

86%

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

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.

A strong, highly actionable codegen skill: nearly every line is library-specific knowledge Claude cannot infer, anchored by two complete canonical examples and concrete troubleshooting. The main weaknesses are minor redundancy between the defaults list and the examples, and the non-portable absolute example paths in place of a proper reference structure.

Suggestions

Replace the absolute /Users/vr/src/ax/... paths in 'Good Example Targets' with portable references (repo-relative paths or bundled example files under references/), since no other user can resolve those paths.

Consolidate the option explanations in 'Use These Defaults' and 'Useful Options' — they overlap with the inline options in the two canonical examples — to trim roughly a dozen lines without losing information.

Consider moving the full AxGEPA constructor options reference and the example-target listing into a references/ file, keeping SKILL.md as a lean overview with well-signaled one-level-deep links.

DimensionReasoningScore

Conciseness

The body is dense with non-inferable library specifics (baseline semantics, bootstrap trace rules, isExpensive teacher handling) rather than concepts Claude already knows, but there is minor redundancy — the 'Use These Defaults' list overlaps the canonical examples' option sets, and the three long baseline-semantics bullets in Critical Rules could be tightened.

4 / 5

Actionability

Two complete, copy-paste-ready TypeScript examples (scalar and Pareto) include imports, model setup, metrics, full option objects, and result application, and the Troubleshooting section gives concrete fixes like "increase it until the initial validation pass fits" and `teacherOptions: { useExpensiveModel: 'yes' }`.

5 / 5

Workflow Clarity

The Metric Selection section and 'Rule of thumb' clearly route between `optimize(...)`, plain evaluators, and `agent.optimize(...)`, and Troubleshooting provides error-recovery feedback loops; however, the guidance is presented as rules rather than an explicit sequenced workflow with checkpoints, leaving minor gaps.

4 / 5

Progressive Disclosure

A single-file skill with no bundle, organized into clear, logically ordered sections (defaults, critical rules, metric selection, patterns, budgeting, troubleshooting). At ~270 lines, the full options reference and six example targets could live in a separate reference file, and 'Good Example Targets' cites non-portable absolute paths (`/Users/vr/src/ax/...`) that other users cannot access.

4 / 5

Total

17

/

20

Passed

Description

86%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-constructed description with an explicit what-and-when structure and comprehensive, natural trigger terms for the AxGEPA niche. Its only weakness is that the capability statement covers a single action while the skill actually handles several, slightly underselling its scope.

Suggestions

Enumerate the skill's concrete actions in the capability sentence, e.g. "Generates AxGEPA optimization code for generators, flows, and agent trees, including Pareto runs, metric selection, and applying/serializing optimized programs."

Qualify the generic trigger terms to reduce conflict risk, e.g. "multi-objective prompt tuning with @ax-llm/ax" so requests about other optimization frameworks do not fire this skill.

DimensionReasoningScore

Specificity

"helps an LLM generate correct AxGEPA optimization code using @ax-llm/ax" names the domain and one concrete action, but does not enumerate the several distinct capabilities the skill covers (tuning generators/flows/agent trees, Pareto runs, applying and serializing optimized programs) — matching the 1–2-actions anchor rather than the several-actions anchor above.

3 / 5

Completeness

It explicitly states what the skill does ("generate correct AxGEPA optimization code using @ax-llm/ax") and when to use it, with a concrete "Use when the user asks about..." clause listing specific trigger phrases.

5 / 5

Trigger Term Quality

"AxGEPA, GEPA, Pareto optimization, multi-objective prompt tuning, reflective prompt evolution, validationExamples, maxMetricCalls, or optimizing a generator, flow, or agent tree" covers natural user phrasings with synonyms plus API-level keywords, comprehensive for this domain.

5 / 5

Distinctiveness Conflict Risk

Firmly anchored to the niche AxGEPA/@ax-llm/ax tooling, but generic triggers like "Pareto optimization" or "multi-objective prompt tuning" could also fire for users of other prompt-optimization frameworks, creating minor overlap risk with closely related skills.

4 / 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

Path

website/static/typescript/.well-known/agent-skills/ax-gepa/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.