CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ax-cpp-agent-context

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

Quality

73%

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-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 tight, well-structured reference sheet for the axllm C++ package that respects token budget completely. Its weakness is execution guidance: the central routing decision (which of contextMap/contextPolicy/optimization/recall to use) has no selection criteria, and the lone code example is incomplete, leaving the reader to consult package examples that are not bundled.

Suggestions

Add a short decision table or if/when criteria mapping task characteristics (persistent corpus vs within-run compaction, offline vs online, recall needs) to contextMap, contextPolicy, optimization, and recall — the body currently states the choice must be made but never how.

Make the Core Pattern snippet self-contained by showing how `llm` is obtained (e.g., a no-key transport construction), so the example is copy-paste runnable for a deterministic local check.

Either bundle the referenced files (API.md, axir-api.json, axir-capabilities.json, or a curated subset) or convert the bare names into resolvable relative links so navigation to the detail material actually works.

DimensionReasoningScore

Conciseness

The body is lean and factual throughout — terse bullet lists ('Real network support: yes.'), one short code snippet, and no explanation of concepts Claude already knows. Every section carries only information specific to the axllm package, and no version numbers or dates appear in the body.

5 / 5

Actionability

The Core Pattern snippet is concrete but not executable as written since `llm` is never constructed or defined, and the 'Relevant API Surface' is a bare list of names with no call shapes. Most importantly, the skill's stated core task — 'Choose between contextMap, contextPolicy, optimization, and recall' — is given no decision criteria or concrete selection guidance, only guardrails pointing to example files that are not in the bundle.

3 / 5

Workflow Clarity

Guidance exists ('Start from package examples for exact native syntax', 'Use `no-key` examples for deterministic local checks') but is presented as unsequenced bullets with no ordered procedure or decision flow for the feature-routing task. This is not a destructive or batch skill so the validation cap does not apply, but there is no explicit sequence to reach anchor 4.

3 / 5

Progressive Disclosure

The under-50-line body is well organized into clear sections (When To Use, Package Facts, Core Pattern, API Surface, Guardrails) with nothing inlined that belongs in a separate file. However, the referenced materials — 'API.md', 'axir-api.json', 'axir-capabilities.json', 'examples/' — do not exist in the skill bundle and are named rather than linked, so navigation is asserted but not resolvable.

4 / 5

Total

15

/

20

Passed

Description

66%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 distinct, appropriately technical description for a niche package skill with an explicit 'Use when' trigger and identifiable feature scope. Its main weaknesses are a jargon-heavy, synonym-poor trigger vocabulary and the absence of a standalone 'what this does' capability statement — the purpose is folded into the usage clause.

Suggestions

Lead with a standalone capability statement in third person (e.g., 'Selects the right axllm context feature — context maps, trajectory context policy, ACE/GEPA offline optimization, or memory recall — for C++ agent code.'), then append the 'Use when' clause with concrete trigger phrases.

Broaden trigger vocabulary with natural synonyms users would type, such as 'prompt optimization', 'GEPA', 'context selection', or 'long-context C++ agents', to improve keyword coverage beyond package-internal jargon.

DimensionReasoningScore

Specificity

It names the domain ('writing C++ code with `axllm`') and concrete feature areas ('context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall'), but the only action framing is the abstract 'deciding between' — there is no list of concrete actions performed. It sits above anchor 2 (features are specific, not generic) but below anchor 4 (no several specific actions are enumerated).

3 / 5

Completeness

The 'when' is explicit ('Use when writing C++ code with `axllm`') and the 'what' is present ('deciding between context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall'), but the what is embedded inside the when-clause rather than stated as a standalone capability statement with its own concrete trigger phrases. This matches anchor 4 and falls short of anchor 5's fully explicit both-parts form.

4 / 5

Trigger Term Quality

Terms like 'axllm', 'ACE/GEPA', 'context maps', and 'long-context agents' are what a user of this niche package would plausibly say, so this is above anchor 2. But the phrasing is jargon-dense and misses natural variations a user might actually type (e.g., 'prompt optimization', 'context selection', 'C++ agent'), keeping it below anchor 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — C++ code with the specific generated package `axllm` for Ax-specific concerns (AxIR, ACE/GEPA, trajectory context policy). Triggers are distinct and it is very unlikely to fire for any unrelated skill, matching anchor 5.

5 / 5

Total

15

/

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/cpp/.well-known/agent-skills/ax-cpp-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.