CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-llm

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for using the generated Ax package, factory functions, package docs, examples, and API reference.

56

Quality

71%

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/go/.well-known/agent-skills/ax-go-llm/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 compact, well-sectioned reference whose guidance leans on bundle files (`API.md`, `examples/`, `axir-api.json`) that are not present, leaving a single code fragment plus symbol lists as the only directly usable material. There is also an alias inconsistency (`ax.NewAI` vs `axllm.*`) between the Core Pattern and the API surface list, and no sequenced workflow with validation checkpoints.

Suggestions

Include one complete, runnable Go example in SKILL.md (package main, full imports, a call and error check) so the skill is actionable even before the referenced examples/ files are consulted, and make the Core Pattern's alias consistent with the API surface list (`ax.` vs `axllm.*`).

Move the ~40-symbol Relevant API Surface enumeration into the referenced API.md and keep only the key entrypoints (e.g. NewAI, NewAx, NewAgent, NewFlow, Optimize) in SKILL.md, so the body is an overview that navigates to detail.

Add a short ordered workflow with a validation checkpoint, e.g. 1) find the closest example in examples/, 2) adapt it, 3) verify the call shape against API.md/axir-api.json before presenting code, so the process does not depend on implicit steps.

DimensionReasoningScore

Conciseness

The body is lean and list-driven with no explanations of concepts Claude already knows, and one small code snippet. Minor trim opportunities keep it below anchor 5: the intro sentence "This skill helps an agent write Go code with the generated Ax package `github.com/ax-llm/ax/packages/go`" repeats the frontmatter description, the package path appears twice (Package Facts and the Core Pattern import), the ~40-symbol flat enumeration on one line is dense, and "Find ordered or adaptive provider-balancing guidance in the language-specific AI skill" is a vague pointer. It is well above anchor 3's noticeable-padding level.

4 / 5

Actionability

The Core Pattern gives real code (`llm := ax.NewAI("openai", map[string]ax.Value{"apiKey": os.Getenv("OPENAI_API_KEY")})`) but it is a fragment, not an executable program, and its `ax.` prefix conflicts with the `axllm.*` symbols listed in Relevant API Surface. The remaining guidance ("Start from package examples", "Use `provider-api` examples", "Use `no-key` examples") defers to `examples/` and `API.md`, none of which exist in the bundle. This matches anchor 3 (some concrete guidance but incomplete, missing key details) rather than anchor 4's mostly-executable guidance.

3 / 5

Workflow Clarity

"When To Use" and "Guardrails" provide decision guidance (e.g. "Start a generated-language Ax program from package docs or examples", "Use `no-key` examples for deterministic local checks") but there is no sequenced workflow with checkpoints — how to go from examples to written, verified code is implicit and hinges on files absent from the bundle. It fits anchor 3 (steps/guidance present but validation checkpoints missing or implicit); no destructive or batch operations apply, so no hard cap is triggered.

3 / 5

Progressive Disclosure

Sections are well organized and referenced paths are clearly signaled ("Package API docs: `API.md` and `axir-api.json`", "Runnable examples: `examples/`"), but the bundle contains no such files — the references dangle — and the long inlined Relevant API Surface symbol list is exactly the content that belongs in the separate `API.md`. This lands on anchor 3 (some structure, references present, but content that should be separate is inline) rather than anchor 4, since navigation to the referenced detail is not actually possible.

3 / 5

Total

13

/

20

Passed

Description

73%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 well-targeted description with an explicit 'Use when' trigger and a highly distinct package-scoped niche. Its main weakness is that the capability statement lists resources ('for using the generated Ax package, factory functions, package docs, examples, and API reference') rather than concrete actions, and the doubled 'using... for using' phrasing muddies the 'what'.

Suggestions

Rewrite the capability clause as concrete third-person actions, e.g. "Writes Go code against the generated Ax package: builds signatures, AxGen programs, agents, flows, and optimizers using its factory functions, package docs, and API reference."

Add a few natural trigger synonyms users would say (e.g. "golang", "ax-llm", "Ax for Go") so the skill triggers on phrasing variations.

DimensionReasoningScore

Specificity

The description names the domain very precisely ("writing Go code with `github.com/ax-llm/ax/packages/go`") but its actions are minimal: "for using the generated Ax package, factory functions, package docs, examples, and API reference" enumerates resources rather than concrete actions like the anchor-4 example ("Extracts text... fills forms, converts pages to images"). It fits anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is above anchor 2 because the domain is named with an exact package path, not generic.

3 / 5

Completeness

It has both an explicit "when" ("Use when writing Go code with `github.com/ax-llm/ax/packages/go`") and a "what" (using the generated Ax package, factory functions, docs, examples, API reference). The "what" is weakened by the awkward "for using... for using" construction and reads as a resource list rather than a clear capability statement, so it does not reach anchor 5's clearly-and-explicitly-both level; it is above anchor 3 because the "when" is fully explicit, not merely implied.

4 / 5

Trigger Term Quality

"writing Go code", "Ax package", "factory functions", "package docs", "examples", "API reference", plus the import path itself give good keyword coverage a user working with this library would naturally say. It falls short of anchor 5's comprehensive synonym coverage (no "golang", "ax-llm", "LLM" variants), and is well above anchor 3's merely-some-relevant-keywords bar.

4 / 5

Distinctiveness Conflict Risk

Triggering is pinned to a single exact package import path (`github.com/ax-llm/ax/packages/go`), giving it a clear niche with distinct triggers and minimal conflict risk even against generic Go-coding skills. It clearly matches anchor 5.

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.