CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-python-gepa

Use when writing Python code with `axllm` for GEPA, Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts.

64

Quality

80%

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/python/skills/ax-python-gepa/SKILL.md
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 lean, well-structured overview that adds only non-inferable package facts and avoids all padding. Its main weakness is actionability: the core pattern is a placeholder sketch with undefined variables and no in-file executable example, deferring all concrete detail to package examples.

Suggestions

Make the Core Pattern executable by showing how `reflection_client` and `evaluator` are obtained (e.g. an import and construction line from a real example), or inline a complete minimal runnable snippet copied from `examples/` so the anchor pattern is copy-paste ready.

For the 'inspect a GEPA artifact' use case, name the concrete entry point (which module/function or file to read), since currently no guidance exists for that listed task.

DimensionReasoningScore

Conciseness

The body is lean throughout: no concept explanations, no padding, and every line carries package-specific facts Claude cannot infer ('Real network support: yes. Scripted no-key transport support: yes.', 'Runtime profiles: `javascript-quickjs`, `python-pyodide`'). This matches anchor 5 — every token earns its place — and clearly exceeds anchor 4's 'minor instances of over-explanation', of which there are none.

5 / 5

Actionability

The Core Pattern shows the real call shape ('engine = AxGEPA(reflection_client); result = engine.optimize(request, evaluator)') but relies on undefined placeholders — `reflection_client`, `request`, and `evaluator` are never constructed — and defers exact syntax to package examples ('Start from package examples for exact native syntax'). This fits anchor 3's 'missing key details' / sketch-code level rather than 4's 'concrete code with minor gaps'; it is above 2 because the API surface list and guardrails give substantial concrete direction.

3 / 5

Workflow Clarity

The content is well-organized into When To Use, Package Facts, Core Pattern, API Surface, and Guardrails, with clear branching guidance ('Use `no-key` examples for deterministic local checks', 'Use BootstrapFewShot before GEPA when demonstrations should seed optimization'). No destructive or batch operations are involved so no validation cap applies, but the skill spans several tasks (run the optimizer, inspect artifacts, track budgets) without per-task sequencing, placing it at anchor 4 rather than the simple-skill 5, which requires a single unambiguous action.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references; sections are well-organized and the pointers it does give ('Package API docs: `API.md` and `axir-api.json`', 'Runnable examples: `examples/`') are clearly signaled, one level deep, and point to package artifacts rather than nesting skill references. Per the simple-skill guideline this fits the top anchor.

5 / 5

Total

17

/

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 distinctive, appropriately triggered description for a narrow package niche, held back by topic-noun enumeration instead of concrete capability verbs. Adding 2-3 explicit actions and natural synonym variations would raise specificity and trigger coverage.

Suggestions

Convert the topic list into concrete capability verbs, e.g. 'Run the GEPA optimizer, seed demonstrations with BootstrapFewShot, and track metric budgets, reflection calls, and Pareto fronts' — this raises specificity from listing domains to listing actions.

Add natural synonym variations users would say, such as 'Pareto front' (used in the body but absent from the description) and 'prompt optimization', to improve trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain precisely ('writing Python code with `axllm` for GEPA') but enumerates noun-topic phrases ('Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts') rather than concrete actions like 'run the GEPA optimizer' or 'track metric budgets'. It fits anchor 3 — domain named with only an implied action — rather than 4, which requires several specific actions, and is well above 2's generic-domain level.

3 / 5

Completeness

Both parts are present: what ('writing Python code with `axllm` for GEPA, Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts') and an explicit when ('Use when writing Python code with `axllm`...'). It falls short of anchor 5 because the 'what' leans on a topic list rather than explicit capability statements, matching anchor 4's 'when could be more explicit or specific' band; the explicit 'Use when' clause rules out 3.

4 / 5

Trigger Term Quality

Terms 'GEPA', 'Pareto tradeoffs', 'reflection clients', 'metric budgets', 'optimizer state', and 'axllm' are the natural vocabulary a user of this package would say, giving good coverage. It is not 5 because common variations and synonyms are missing — e.g. 'Pareto front' (which the body itself uses) and 'prompt optimization' — but coverage exceeds anchor 3's partial-keyword level.

4 / 5

Distinctiveness Conflict Risk

The unique package name 'axllm' and algorithm name 'GEPA' establish a clear niche with distinct triggers; virtually no other skill would match these terms, fitting anchor 5's 'clear niche with distinct triggers; minimal 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.