CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-cpp-signature

Use when writing C++ code with `axllm` for string signatures, field descriptors, JSON schema output, validation, and typed tool argument shapes.

60

Quality

76%

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

Quality

Content

65%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 code-first, well-sectioned skill with genuine API syntax and clearly signaled external materials, held back by a dense inline Typesafe/Jev policy section, snippets that are fragments rather than runnable programs, no error-recovery guidance around validation, and referenced bundle files that are absent from the bundle.

Suggestions

Move the Typesafe/Jev policy (thresholds, probability tolerance rules, balancer behavior) into a dedicated reference file (e.g., references/typesafe.md) and keep a 3-4 line summary with a clear pointer in SKILL.md.

Add one complete, runnable example in the body or ensure the referenced `examples/` directory ships with the bundle, since `API.md`, `axir-api.json`, and `examples/` are cited but not present.

Include a brief error-recovery note for the validation step (what to do when `validate_signature` fails) and fix the duplicated "Tools: `axllm::Tool`, `axllm::Tool`" entry.

DimensionReasoningScore

Conciseness

The body is mostly lean: compact fact lists ("Package Facts"), one-line lead-ins, and code-first pattern sections with no explanation of concepts Claude already knows. Minor slack exists, such as the duplicated bullet "Tools: `axllm::Tool`, `axllm::Tool`" and the triple naming-variant listings ("system_one / systemOne / SystemOne") in the Typesafe section. It is not a 5 because those trims are needed; not a 3 because the dense Typesafe prose is domain policy the model cannot know, not padding or over-explanation.

4 / 5

Actionability

Real-syntax, illustrative C++ snippets cover the common cases ("axllm::s(\"question:string -> answer:string\")", "axllm::Core::validate_signature(signature)", "program.forward(client, inputs)"), and the body directs the agent to complete programs under `examples/`. It is not a 5 because several fragments reference undefined variables (`signature`, `client`, `inputs`) and no snippet is copy-paste runnable end-to-end; not a 3 because the code is genuine generated-package syntax rather than pseudocode and the gaps are minor.

4 / 5

Workflow Clarity

The "More Patterns" section loosely sequences usage from simple string contract to constrained fields to "Validate and render" to "Reuse the signature", and the "Validate and render" pattern provides a checkpoint (`axllm::Core::validate_signature`). It is not a 4/5 because there is no guidance on what to do when validation fails, no end-to-end flow (define signature -> validate -> build schema -> forward -> handle errors), and the Typesafe workflow is scattered across five dense paragraphs. Not a 2 because a recognizable sequence and at least one validation checkpoint are present; the operations are not destructive or batch, so no cap applies.

3 / 5

Progressive Disclosure

The body is well-sectioned and clearly signals its materials ("Package API docs: `API.md` and `axir-api.json`", "Runnable examples: `examples/`", plus an external gallery URL), but none of these referenced files exist in the skill bundle, so navigation dead-ends. Additionally, the ~18 lines of dense inline Typesafe/Jev policy (thresholds, probability tolerances, balancer behavior) is content that clearly belongs in a separate reference file. It is not a 4 because the inline Typesafe section and dangling references are more than minor gaps; not a 2 because headers, a clear overview, and explicit pointers to per-topic materials exist.

3 / 5

Total

14

/

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 description with an explicit trigger clause and a specific, well-scoped niche. Its main limitation is that capabilities are listed as noun phrases rather than concrete actions, which slightly blurs the "what does this do" answer.

DimensionReasoningScore

Specificity

The description names five concrete capability areas ("string signatures, field descriptors, JSON schema output, validation, and typed tool argument shapes") rather than vague language, but these are noun phrases rather than stated actions, so coverage is specific without being fully action-oriented. It is not a 3 because the listed items go well beyond 1-2 concrete actions, and not a 5 because no concrete verbs (e.g., declare, generate, validate) articulate what is actually done with each capability.

4 / 5

Completeness

Both parts are present: an explicit "Use when writing C++ code with `axllm` for..." trigger clause and a concrete what (the five capability areas). It is not a 5 because the what is a purpose clause merged into the when rather than a distinct, clearly articulated action list; not a 3 because the explicit "Use when..." clause and specific what exceed the weakly-implied anchor.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "writing C++ code", "string signatures", "JSON schema", "validation", and "tool argument shapes". It is not a 5 because common variations and synonyms (e.g., "Ax signature", "schema", "C++ Ax project") are missing; not a 3 because the included keywords are natural and multiple rather than generic filler.

4 / 5

Distinctiveness Conflict Risk

The combination of "C++", "`axllm`", and "string signatures" carves out a clear niche with distinct triggers; no other common skill would fire on this description. It clearly matches the minimal-conflict-risk anchor.

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.