CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-agent-observability

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for agent tracing, centralized and multi-tenant usage accounting, action logs, runtime diagnostics, replay, and production debugging.

66

Quality

83%

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

SKILL.md
Quality
Evals
Security

Quality

Content

68%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, dense reference for a generated Go package: real code snippets, precise package-specific semantics, and clear guardrails. Weaknesses are the absence of any sequenced workflow with validation checkpoints (e.g., confirm events are emitted before trusting usage accounting) and code snippets that reference undefined variables, plus an inline API symbol dump that duplicates the referenced API.md.

Suggestions

Add an explicit numbered workflow for the usage observer (register observer, attach usageContext, run the agent, verify events were emitted, clear observer on teardown) so accounting flows have a validation checkpoint.

Make the code snippets self-contained: include imports and define `llm` and `usageQueue` (or a minimal bounded-queue implementation) in the examples, since the guardrail itself warns against inventing call shapes.

Trim the 'Relevant API Surface' symbol list to the handful of symbols the documented workflows actually use and delegate the full surface to API.md, which is already referenced under Package Facts.

DimensionReasoningScore

Conciseness

The body is mostly lean and package-specific ('The observer is process-wide, best-effort, and fail-open', 'Nested `attributes` are shallow-merged') with no explanations of concepts Claude already knows. It is not a 5 because the ~40-symbol one-line enumeration in 'Relevant API Surface' is padding that could be delegated to API.md, which the skill itself lists as the package API doc.

4 / 5

Actionability

Concrete Go snippets ('ax.NewAgent("question:string -> answer:string", nil)', 'axllm.SetUsageObserver(func(event axllm.AxUsageEvent) {...})') plus precise option-map and teardown guidance make this mostly executable. It is not a 5 because the Core Pattern references an undefined `llm` and the observer snippet uses an undefined `usageQueue`, so neither is copy-paste runnable standalone; it is above a 3 because the code is real Go, not pseudocode, and the guardrail points to runnable examples.

4 / 5

Workflow Clarity

The observer lifecycle (register observer, attach usageContext for attribution, clear during teardown) is conveyed but implicitly, spread across bullets with no sequenced steps and no validation checkpoint such as verifying that usage events were actually emitted before relying on accounting. It is not a 2 because a coherent rough flow is present across the sections; not a 4 because checkpoints are missing entirely rather than having minor gaps.

3 / 5

Progressive Disclosure

The body is clearly sectioned (When To Use, Package Facts, Core Pattern, usage observer, Guardrails) with one-level references to API.md, axir-api.json, axir-capabilities.json, examples/, and a specific runnable example path. It is not a 5 because the long inline API symbol list is content that belongs in the referenced API.md rather than the overview.

4 / 5

Total

15

/

20

Passed

Description

92%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: it combines an explicit 'Use when...' trigger tied to a unique package import path with a comprehensive, concrete list of capabilities in third-person voice. The only gap is a few natural synonyms (observability, telemetry, metrics) that users might use when asking for this skill.

DimensionReasoningScore

Specificity

The description enumerates six concrete capability areas — 'agent tracing, centralized and multi-tenant usage accounting, action logs, runtime diagnostics, replay, and production debugging' — matching the anchor for multiple specific concrete actions with comprehensive coverage of the package's surface. It is not a 4 because the coverage spans the package's full capability set rather than leaving minor gaps.

5 / 5

Completeness

'Use when writing Go code with `github.com/ax-llm/ax/packages/go` for agent tracing...' explicitly answers both questions: the 'when' is a concrete trigger clause (writing Go code with this specific package) and the 'what' is the explicit capability list. Not a 4 because the when-clause is explicit and specific rather than weakly implied.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ('Go code', 'agent tracing', 'usage accounting', 'runtime diagnostics', 'replay', 'production debugging') plus the package import path, giving good keyword coverage. It is not a 5 because common synonyms users might say — 'observability', 'telemetry', 'metrics', 'golang' — are missing; it is above a 3 since several natural terms are covered, not just one or two.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a single unique package path (`github.com/ax-llm/ax/packages/go`), giving it a clear niche with distinct triggers and minimal conflict risk with other skills. Not a 4 because it does not merely reduce overlap — the import path alone disambiguates it from any similar skill.

5 / 5

Total

19

/

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.