CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-cpp-gepa

Use when writing C++ 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 ./website/static/cpp/.well-known/agent-skills/ax-cpp-gepa/SKILL.md
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 lean, well-structured reference body: concise package facts, a concrete API surface, and unusually good guardrails that encode decision rules (transport choice by credentials, BootstrapFewShot-before-GEPA ordering, AxIR as source of truth). The main gaps are a code pattern with unresolved placeholders and referenced documentation files that are not part of the skill bundle, leaving the agent to locate them in the package.

DimensionReasoningScore

Conciseness

The body is ~45 lines with no filler: every line states a fact, a guardrail, or an API name ('Package: `axllm`', 'Runtime profiles: `javascript-quickjs`, `python-pyodide`'). It explains nothing Claude already knows and assumes competence throughout, matching the lean anchor 5 ('every token earns its place').

5 / 5

Actionability

The Core Pattern gives real C++ syntax ('axllm::AxGEPA engine(reflection_client, options); auto result = engine.optimize(request, evaluator);') and the API surface lists concrete symbols, plus 'Start from package examples for exact native syntax' directs to working code. It stops short of anchor 5 because the snippet uses undefined placeholders (reflection_client, options, request, evaluator) with no includes or setup, so it is not copy-paste ready and the common cases aren't covered inline.

4 / 5

Workflow Clarity

As a single-purpose reference skill, the guidance is unambiguous about what to do first ('Start from package examples...') and includes sequencing and decision rules ('Use BootstrapFewShot before GEPA when demonstrations should seed optimization'; choose `no-key` vs `provider-api` examples by credential availability). It misses anchor 5 because there is no explicit checkpoint or validation step in the optimize/evaluate loop, and the actual workflow (wiring an evaluator, running an optimization) is left to the examples.

4 / 5

Progressive Disclosure

Sections are well organized (When To Use, Package Facts, Core Pattern, API Surface, Guardrails) and external materials are clearly enumerated in one place ('Package API docs: `API.md` and `axir-api.json`', 'Runnable examples: `examples/`'). It falls below anchor 5 because those referenced paths (API.md, axir-api.json, axir-capabilities.json, examples/) do not exist in the skill bundle itself, and the API symbol list is inlined rather than deferred — navigation depends on files the agent must find elsewhere in the package.

4 / 5

Total

17

/

20

Passed

Description

70%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 highly distinct, jargon-accurate description whose 'when' trigger is explicit and whose topic list is concrete, but it never states what the skill actually does — the capability statement is implied rather than written. Adding a leading 'what' clause with action verbs would lift it from good to excellent.

Suggestions

Prepend an explicit 'what' statement before the 'Use when' clause, e.g., 'Guides use of the generated C++ `axllm` package for GEPA prompt optimization. Use when writing C++ code with `axllm`...'.

Convert topic nouns into concrete actions to raise specificity, e.g., 'run the GEPA optimizer, inspect artifacts, track metric budgets and Pareto fronts' instead of a bare noun list.

Add one or two natural synonyms users might say, such as 'prompt optimization' or 'LLM optimizer', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description names the domain ("writing C++ code with `axllm`") and lists several concrete capability areas ("GEPA, Pareto tradeoffs, reflection clients, metric budgets, optimizer state, and artifacts"), giving clear scope with only minor gaps. It sits above anchor 3 (which expects just 1-2 concrete actions with thin coverage) but below anchor 5 because the items are topic nouns rather than enumerated actions (no verbs like 'run the optimizer' or 'track budgets').

4 / 5

Completeness

The 'when' is explicit ("Use when writing C++ code with `axllm` for GEPA, Pareto tradeoffs...") but the 'what' is only implied — the description never states what the skill provides or does (e.g., 'Guides usage of the generated axllm package...'). Scoring only what is explicitly stated, this matches anchor 3 (one of what/when missing or implicit); it is not anchor 4, which requires both an explicit 'what' and an explicit 'when'.

3 / 5

Trigger Term Quality

Phrases like "C++ code with `axllm`", "GEPA", "Pareto tradeoffs", "reflection clients", and "metric budgets" are exactly the natural vocabulary a user of this package would say. It falls short of anchor 5 because common variations and synonyms (e.g., 'prompt optimization', 'LLM optimizer', 'candidate evaluation') are missing, but coverage is good rather than merely adequate.

4 / 5

Distinctiveness Conflict Risk

The pairing of "C++" with "`axllm`", "GEPA", and "reflection clients" carves out a clear niche with essentially no overlap risk against other skills — only someone working with this exact generated package would match these triggers.

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.