CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

61

Quality

77%

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/cpp/skills/ax-cpp-agent-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

72%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-organized skill sheet that avoids padding entirely, but it under-delivers on its stated purpose: it promises to help decide between contextMap, contextPolicy, optimization, and recall yet provides no decision criteria or routing rules for that choice. The Core Pattern is the only code and is not self-contained.

Suggestions

Add a short decision table or routing rules under 'When To Use' stating when to choose contextMap vs contextPolicy vs optimization vs recall (e.g., task shape, corpus persistence, latency constraints), since this is the skill's core promise.

Make the Core Pattern self-contained by showing how the 'llm' instance is constructed, so the snippet is copy-paste executable.

Add a validation step (e.g., run a no-key example to verify the chosen feature compiles and round-trips) as a checkpoint after selection.

DimensionReasoningScore

Conciseness

The body is lean and assumes competence: terse fact lists ('Real network support: yes. Scripted no-key transport support: yes.'), a compact 'Relevant API Surface' list, and no explanations of concepts Claude already knows. Every section carries information, matching the 'every token earns its place' anchor.

5 / 5

Actionability

The Core Pattern ('auto helper = axllm::agent("question:string -> answer:string");') is concrete C++ but depends on an undefined 'llm' variable, and 'When To Use' says 'Choose between contextMap, contextPolicy, optimization, and recall for a task' without any criteria for how to choose — the skill's core promised function has no executable decision guidance. This matches the 'some concrete guidance but incomplete; missing key details' anchor rather than 4, where guidance would be mostly executable.

3 / 5

Workflow Clarity

The routing workflow is a rough bullet list ('Choose between...', 'Avoid mixing persistent corpus orientation with within-run compaction', 'Route long-context agent work...') with no decision sequence, no checkpoints, and no validation steps; the Guardrails section partially compensates with do/don't rules. This sits between anchor 2 (many gaps, validation absent) and anchor 3 (sequence present but checkpoints missing) — closer to 3 because the guardrails act as implicit checkpoints, but not 4 since the decision flow for the skill's primary task is undefined.

3 / 5

Progressive Disclosure

The skill is under 50 lines with clear, well-organized sections and no external bundle files; references to 'API.md', 'axir-api.json', 'axir-capabilities.json', and 'examples/' are package artifacts clearly signaled as such and one level deep. Per the simple-skill scoring note, this matches the top anchor.

5 / 5

Total

16

/

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 tight, niche-specific description with an explicit 'Use when' clause, good trigger-term coverage including synonym variants, and minimal conflict risk. Its main weakness is that the skill's own action is never stated directly — 'what' is inferred from the user's task phrasing rather than declared.

Suggestions

State the skill's action explicitly in third person, e.g., 'Guides selection between context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall...' before the 'Use when' clause.

Add one or two broader natural phrasings users might use, such as 'context window management' or 'prompt optimization', to widen trigger coverage.

DimensionReasoningScore

Specificity

It names the domain ('writing C++ code with `axllm`') and enumerates four concrete decision targets ('context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall'), but the only action verb belongs to the user's activity ('writing C++ code'), not the skill — what the skill actually does is implied. This matches anchor 3 (domain and concrete items, but not comprehensive) rather than 4, whose examples list several specific actions the skill itself performs.

3 / 5

Completeness

The 'when' is explicit ('Use when writing C++ code with `axllm` for...'), and a 'what' is present ('deciding between context maps, trajectory context policy, offline optimization (ACE/GEPA), and memory recall') but carried by an indirect prepositional clause rather than an explicit skill-action statement. This sits between anchor 3 (what clear, when weak) and anchor 4 (both present, one could be more specific) — above the midpoint because the when is fully explicit, but short of 5 because the what lacks a direct action verb.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'C++', 'axllm', 'context maps', 'trajectory context policy', 'offline optimization', 'ACE', 'GEPA', 'memory recall', 'long-context agents', with synonym variants (ACE/GEPA). Missing a few broader phrasings users might naturally use (e.g., 'context window', 'prompt optimization'), so it falls just short of the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The trigger terms are highly specific to a niche ('C++', 'axllm', 'ACE/GEPA', 'trajectory context policy'), creating a clear niche with distinct triggers and minimal risk of firing for unrelated skills — matching the top anchor exactly.

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.