CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-cpp-agent

Use when writing C++ code with `axllm` for agents, child delegation, tools, MCP, citations, persistent playbook learning, stage instructions, runtime state, final typed responses, and direct-respond executor skipping.

53

Quality

67%

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/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%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.

The body is well-organized and dense with non-obvious package-specific facts, but it reads as an inlined behavioral specification rather than an actionable overview: one executable snippet across a very wide feature surface, cross-language digressions, and referenced files that are not present in the bundle. Moving the deep behavioral detail into bundled reference files and adding runnable C++ examples for the main scenarios would raise it substantially.

Suggestions

Move the dense behavioral specification in 'Astra Session Work' (session lifecycle, cancellation, steering, WebSocket adapters) into a bundled reference file and keep a short summary with a clearly signaled link, so the referenced files actually exist alongside SKILL.md.

Add small executable C++ examples for the main scenarios (child agent registration and invocation, MCP client setup, streaming_forward usage) instead of descriptive prose, mirroring the existing two-line Core Pattern.

Trim cross-language material (Go/Java/Rust/Python API names and 'All five session adapters' parity notes) from this C++ skill, or relocate it to a dedicated portability reference file.

DimensionReasoningScore

Conciseness

Most of the body is genuinely non-obvious package-specific behavior, but it includes unnecessary material: cross-language API digressions in a C++ skill ("add_child_agent in Python/C++, AddChildAgent in Go, addChildAgent in Java, and with_child_agent in Rust"; "All five session adapters"; Rust/Java/Python specifics in the flow-node section) and repeated "as in TypeScript" comparison qualifiers. This sits at the 3 anchor (mostly efficient, some content to trim) rather than 2, since the padding is localized rather than pervasive.

3 / 5

Actionability

There is one real executable snippet (the two-line "Core Pattern" with `axllm::agent` and `helper.forward`) and concrete API names (`add_child_agent(namespace, name, child)`, `agent.streaming_forward(client, values, options, handler)`), but nearly all other guidance is descriptive behavior prose with no executable examples for the many scenarios covered (MCP, streaming, child agents, runtime). This matches the 3 anchor — some concrete guidance but incomplete.

3 / 5

Workflow Clarity

Sections are clearly organized and the Guardrails section supplies checks ("Start from package examples for exact native syntax", "Use `provider-api` examples only when the user explicitly has provider credentials"), and ordering directives exist ("Register child agents before running the parent"). But the body is reference prose rather than a sequenced process, and validation checkpoints are implicit at best, matching the 3 anchor.

3 / 5

Progressive Disclosure

The body points to `API.md`, `axir-api.json`, `axir-capabilities.json`, and `examples/`, but none of these files exist in the bundle, so navigation cannot actually be followed from the skill. Meanwhile, long dense behavioral spec (the ~28-line "Astra Session Work" section) is inlined material that belongs in a reference file. This matches the 3 anchor — some structure, references signaled but not loadable from the bundle, content that should be separate is inline.

3 / 5

Total

12

/

20

Passed

Description

71%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 strong description with an explicit, concrete trigger clause and a specific, well-scoped niche. Its main weaknesses are internal jargon in the trigger list and a feature-noun listing that implies, rather than states, what the skill does.

DimensionReasoningScore

Specificity

The description names the domain ("writing C++ code with `axllm`") and lists many concrete capability areas ("agents, child delegation, tools, MCP, citations, persistent playbook learning, stage instructions, runtime state, final typed responses, and direct-respond executor skipping"). It falls short of the 5 anchor because the items are feature nouns rather than explicit concrete actions, and ahead of the 3 anchor because coverage is broad rather than 1-2 actions.

4 / 5

Completeness

The 'when' is explicit and concrete ("Use when writing C++ code with `axllm`"), but the 'what' is only implied by the feature list — the description never states what the skill itself does. Both are present with one weaker side, matching the 4 anchor rather than 5, which requires both clearly and explicitly stated.

4 / 5

Trigger Term Quality

Some natural terms users would say are present ("C++", "agents", "tools", "MCP", "citations", "child delegation"), but several others are internal package jargon no user would naturally say ("persistent playbook learning", "direct-respond executor skipping", "final typed responses", "stage instructions"), and common variations/synonyms are missing. This matches the 3 anchor (some relevant keywords, missing variations) rather than 4, which requires broadly good natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The trigger is pinned to a specific language and package ("C++ code with `axllm`"), forming a clear niche with minimal conflict risk against unrelated skills; the C++ qualifier also disambiguates sibling skills for the same package in other languages. Generic terms like "agents" and "MCP" appear but are dominated by the package pin.

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.