CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-gen

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for AxGen programs, forward calls, indexed multi-sampling, result pickers, streaming, tools, assertions, traces, usage, and output parsing.

55

Quality

69%

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 ./packages/go/skills/ax-go-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 factually precise about the package's semantics, but it functions as an inlined API reference rather than a skill overview: monolithic paragraphs of edge-case detail, only one runnable code example, and heavy detail that should live in one-level-deep reference files. It is accurate yet inefficient for a context window.

Suggestions

Move the per-option behavioral semantics (Provider Forward Options, Astra Session Work, multi-sampling details) into one-level-deep reference files (e.g., references/forward-options.md, references/mcp.md) and keep SKILL.md to the core pattern, package facts, and clearly signaled links.

Replace the wall-of-text paragraphs with compact option tables or bullet lists (option name, default, behavior), trimming edge-case minutiae — e.g., timezone abbreviation handling for 'BST', 'IST', Philippine 'PST' — into the references.

Add one or two complete runnable examples beyond the two-line core pattern (e.g., multi-sampling with a result picker, or attaching a typed tool) so the most common use cases are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is a wall of dense multi-clause paragraphs — e.g., the parseDates paragraph enumerates 'PST is -08:00 all year; ambiguous ones such as BST, IST and CST are rejected; PST/CDT follow US usage, so for Philippine time (PST) or Cuban daylight time (CDT) give an IANA name', and the Astra Session section runs 26 lines of unbroken prose. The facts are package-specific (not general knowledge), but the inlined edge-case detail is far beyond what a SKILL.md needs, matching anchor 2 (noticeably verbose, several padded sections) rather than anchor 3's 'mostly efficient, some tightening'.

2 / 5

Actionability

There is one runnable snippet ('program := ax.NewAx(...)' / 'program.Forward(...)') plus concrete signatures ('func(key string, value map[string]Value) (map[string]Value, error)', 'iter.Seq2[AxGenDelta, error]', 'AddFieldProcessor(field, processor)'), but nearly every other feature — multi-sampling, result pickers, tools, MCP, cancellation — is described semantically with no executable example, leaving key usage details missing. That sits at anchor 3 (some concrete guidance but incomplete), below anchor 4's mostly-executable bar.

3 / 5

Workflow Clarity

A rough sequence is implied by the guardrails ('Start from package examples for exact native syntax before inventing a new call shape', 'Use `no-key` examples for deterministic local checks'), which doubles as an implicit validation checkpoint, but no explicit ordered steps or checkpoints are stated anywhere — anchor 3 (sequence present but implicit, checkpoints missing). The destructive/batch cap does not apply since this is a code-writing skill.

3 / 5

Progressive Disclosure

The 'Package Facts' section does clearly signal external material ('Package API docs: `API.md` and `axir-api.json`', 'Runnable examples: `examples/`'), but roughly 80 lines of per-option behavioral semantics (Astra Session Work, Provider Forward Options) are inlined into SKILL.md where they clearly belong in separate reference files, and no bundle reference files ship alongside — anchor 2 (content that clearly belongs in separate files is inlined) fits better than anchor 3's 'references not clearly signaled'.

2 / 5

Total

10

/

20

Passed

Description

87%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: explicit 'Use when' trigger tied to the exact package, a broad enumerated capability list, and a distinctive niche. Its only weakness is that capabilities are listed as feature nouns rather than concrete actions, and a few natural synonyms ('Golang', 'structured output') are absent.

DimensionReasoningScore

Specificity

The description enumerates ten concrete capability areas — 'AxGen programs, forward calls, indexed multi-sampling, result pickers, streaming, tools, assertions, traces, usage, and output parsing' — but they are stated as feature nouns rather than concrete actions (only the verb 'writing' appears), so it matches anchor 4 (several specific items, minor gaps) rather than anchor 5's fully action-verb coverage.

4 / 5

Completeness

'Use when writing Go code with `github.com/ax-llm/ax/packages/go`' is an explicit, concrete 'when' clause, and the 'what' is the enumerated capability list that follows — both what and when are clearly and explicitly answered with concrete trigger phrases, matching anchor 5. Anchor 4's weakness ('when' could be more explicit) does not apply.

5 / 5

Trigger Term Quality

Phrases like 'writing Go code', 'AxGen', 'forward calls', 'streaming', 'tools', and 'output parsing' are terms a user of this package would naturally say, giving good keyword coverage; a few natural variants are missing (e.g., 'Golang', 'structured output', 'LLM generation'), which keeps it below anchor 5 and comfortably above anchor 3.

4 / 5

Distinctiveness Conflict Risk

Naming the exact Go package path 'github.com/ax-llm/ax/packages/go' and the AxGen-specific feature vocabulary ('forward calls', 'result pickers') carves out a clear niche with minimal overlap risk against generic Go, LLM, or tooling skills.

5 / 5

Total

18

/

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.