ax-cpp-signature

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

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/cpp/skills/ax-cpp-signature/SKILL.md

Quality

Content

75%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 well-structured, token-efficient body with concrete code patterns and clearly signaled references to external detail files. A duplicate API entry and absent bundle files are the main minor weaknesses.

Suggestions

Remove the duplicated 'axllm::Tool' entry under Relevant API Surface.

Ensure referenced bundle files (API.md, axir-api.json, axir-capabilities.json, examples/) are actually present in the skill bundle to back the progressive-disclosure pointers.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes competence, with minimal over-explanation; minor trimming possible (e.g. a duplicated 'axllm::Tool' entry under Relevant API Surface).	4 / 5
Actionability	Provides several concrete, mostly executable C++ snippets (axllm::s, axllm::ax, record_new, validate_signature) covering common cases, with only minor gaps in completeness.	4 / 5
Workflow Clarity	A clear progression from Core Pattern through More Patterns to Guardrails with a 'start from examples' entry point; this is a code-generation skill without destructive batch operations, so explicit validation checkpoints are not strictly required.	4 / 5
Progressive Disclosure	Well-organized sections with clearly signaled one-level-deep references (API.md, axir-api.json, axir-capabilities.json, examples/, and an external URL), though no bundle files are present to confirm the referenced paths resolve.	4 / 5
	Total	16 / 20 Passed

Description

80%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 focused, third-person description that names concrete capabilities and an explicit 'Use when' trigger, clearly scoping the skill to C++ with the `axllm` package. Trigger phrasing is somewhat technical and could add natural synonyms for stronger activation.

Suggestions

Add natural user-facing trigger phrases (e.g. 'or when the user mentions axllm signatures, field descriptors, or JSON schema output') to raise trigger term quality.

Include a synonym or file-extension term users might say (e.g. '.cpp signatures', 'ax signatures') to broaden natural activation.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'string signatures, field descriptors, JSON schema output, validation, and typed tool argument shapes' — giving comprehensive coverage of the package's capabilities.	5 / 5
Completeness	Explicitly states both what (signatures, descriptors, schema, validation, tool args) and when ('Use when writing C++ code with `axllm`'), though the trigger clause could be more specific with concrete user-mentionable phrases.	4 / 5
Trigger Term Quality	Good keyword coverage with natural terms like 'writing C++ code', 'string signatures', 'JSON schema', 'validation', but leans technical and omits common synonyms or file extensions a user might say.	4 / 5
Distinctiveness Conflict Risk	The `axllm` package plus C++ signature niche is mostly distinct with minimal conflict risk, though 'writing C++ code' is broad enough to overlap slightly with general C++ skills.	4 / 5
	Total	17 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: ax-llm/ax
Path: packages/cpp/skills/ax-cpp-signature/SKILL.md
Commit: 781623e

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

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.