CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-cpp-gen

Use when writing C++ code with `axllm` for AxGen programs, forward calls, indexed multi-sampling, result pickers, streaming, tools, assertions, traces, usage, and output parsing.

52

Quality

66%

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

Quality

Content

38%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 information-dense and package-specific rather than padded with general knowledge, but it functions as an inlined specification dump: massive prose paragraphs, almost no executable examples, and references to detail files that do not exist in the bundle. Restructuring into a lean overview with real, present reference files and runnable examples is the highest-leverage fix.

Suggestions

Split the 'Astra Session Work' and 'Provider Forward Options' sections into reference files (e.g., sessions.md, options.md) and keep only a short summary plus well-signaled links in SKILL.md.

Include the referenced files (API.md, axir-api.json, examples/) in the skill bundle, or inline a few complete, runnable example programs so guidance does not depend on absent files.

Tighten the repeated 'as in TypeScript' comparisons into a single note, and convert option-semantics lists (retry budgets, date parsing, structured-output modes) into compact tables.

DimensionReasoningScore

Conciseness

The body is a ~25KB wall of dense run-on prose with 'as in TypeScript' repeated roughly twenty times, and exhaustive option semantics (retry budgets, timezone-abbreviation rules, JSON number formatting) inlined where a compact table or reference file would do. It matches anchor 2 ('noticeably verbose; several padded sections') rather than 3, since the volume of tightening possible far exceeds 'some unnecessary explanation', though it never explains concepts Claude already knows.

2 / 5

Actionability

Concrete API names and signatures appear inline ('set_sample_count', 'streaming_forward(client, values, options, handler)', the Core Pattern snippet), but only one two-line code example exists and complete executable examples are deferred to 'examples/' and 'src/examples/cpp/...' paths that are absent from the bundle. This lands at 'some concrete guidance but incomplete' rather than 4's 'mostly executable'.

3 / 5

Workflow Clarity

A rough reading order exists (When To Use, Package Facts, Core Pattern, option semantics, Guardrails) with useful guardrails like 'Start from package examples for exact native syntax before inventing a new call shape'. No sequenced workflow for building a program or validation checkpoints is given, keeping it at 3 rather than 4; it stays above 2 because sections are coherent and navigable.

3 / 5

Progressive Disclosure

The 'Astra Session Work' and 'Provider Forward Options' sections inline hundreds of words of reference detail that clearly belongs in separate files, matching anchor 2. Navigation to depth is also broken: the referenced detail files (API.md, axir-api.json, axir-capabilities.json, examples/) are not present in the bundle, so the skill is effectively a monolith with dangling references.

2 / 5

Total

10

/

20

Passed

Description

78%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, niche-specific description with an explicit 'Use when...' trigger and a broad, concrete list of capability areas. Its main weakness is that the 'what' is implied through topic nouns inside the trigger clause rather than stated as explicit actions, which slightly limits both completeness and specificity.

DimensionReasoningScore

Specificity

The description names the domain ('C++ code with `axllm` for AxGen programs') and enumerates many concrete capability areas ('forward calls, indexed multi-sampling, result pickers, streaming, tools, assertions, traces, usage, and output parsing'). It stays at score 4 rather than 5 because these are topic nouns rather than concrete actions, and at 4 rather than 3 because the coverage is broad and specific, well beyond 1-2 actions.

4 / 5

Completeness

An explicit and specific trigger clause is present ('Use when writing C++ code with `axllm` for AxGen programs...'). Not 5 because the 'what' is only implied by the trigger clause — there is no explicit verb statement of what the skill does; not 3 because the 'when' is explicit with concrete triggers, not weakly implied.

4 / 5

Trigger Term Quality

Terms a user in this niche would naturally say are present ('C++', 'streaming', 'tools', 'traces', 'output parsing'), giving good keyword coverage. Not 5 because common variations like 'structured generation/output' or 'LLM calls' are missing and 'indexed multi-sampling' is internal jargon; not 3 because coverage clearly exceeds 'some relevant keywords'.

4 / 5

Distinctiveness Conflict Risk

The description carves out a highly specific niche (`axllm` C++ AxGen programming) with distinct trigger terms, making it unlikely to fire for the wrong skill. It matches the anchor for a clear niche with minimal conflict risk.

5 / 5

Total

17

/

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.