CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-agent

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for agents, child delegation, tools, MCP, citations, persistent playbook learning, stage instructions, runtime state, final typed responses, and direct-respond executor skipping.

57

Quality

72%

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

Quality

Content

50%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 a dense, accurate reference with exact identifiers and one executable core pattern, but it reads as an inlined API/behavior manual: long prose sentences, inline version-migration notes, sparse code examples, and no progressive-disclosure split despite its breadth. It would score higher with reference files offloading the deep behavioral detail and short Go snippets for each major workflow.

Suggestions

Move version-migration statements ('the default since 25.0.0', 'as the ports did before 25.0.0', 'retains the old behavior') into a dedicated 'Old patterns / migration' section or reference file, per the time-sensitivity guideline.

Split deep behavioral detail — Astra session work, MCP cancellation and host policy, and streaming semantics — into reference files (e.g., references/mcp.md, references/streaming.md), keeping SKILL.md a concise overview with one-level-deep, clearly signaled references.

Add short executable Go snippets for the main workflows beyond the Core Pattern, such as child-agent registration (AddChildAgent), StreamingForward iteration, and runtime configuration on the constructor.

DimensionReasoningScore

Conciseness

The body is fact-dense and avoids explaining known concepts, but long winding sentences ('Each run refreshes protocol modules without serializing live client handles into model requests') could be tightened, and version-sensitive statements ('the default since 25.0.0', 'as the ports did before 25.0.0', 'retains the old behavior') are scattered inline instead of a dedicated old-patterns/deprecated section, which the guidelines penalize. Not 4: the version-comparison asides and dense run-on prose are recurring; not 2: most tokens convey non-obvious package-specific facts.

3 / 5

Actionability

There is one complete executable snippet (helper := ax.NewAgent("question:string -> answer:string", nil); out := helper.Forward(...)) and exact identifiers (AddChildAgent, (*AxAgent).StreamingForward(ctx, client, values, options), actorMode: 'completion', axgoja.NewRuntime()), but most behaviors — MCP cancellation, session work, run controllers, child delegation — are described in prose with no code. Not 4: concrete coverage is limited to a single full example across ~100 lines; not 2: exact API names and option keys are given throughout.

3 / 5

Workflow Clarity

Content is organized by topic with 'When To Use' scenarios, but there is no sequenced multi-step workflow or validation checkpoint; the closest is the guardrail 'if package docs disagree with source code, update the compiler and regenerate packages', a recovery directive without a validate-fix-retry loop. Not 4: no explicit sequence of steps exists; not 2: topics are coherently organized and guardrails give some error-recovery direction.

3 / 5

Progressive Disclosure

Clear section headers exist, but ~100 lines of behavioral detail (Astra session semantics, MCP cancellation rules, streaming behavior) are inlined where a reference-file split would serve better; pointers go to package files (examples/, API.md, axir-capabilities.json) rather than skill bundle references, and no bundle files exist. Not 4: substantial reference-grade content is inlined in SKILL.md; not 2: sections are clearly headed and the API surface is summarized rather than dumped.

3 / 5

Total

12

/

20

Passed

Description

83%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 pins a specific package, enumerates concrete capabilities comprehensively, and gives an explicit 'Use when' trigger with low conflict risk. Its only weaknesses are a 'what' that is implicit within the when-clause and a few missing natural trigger synonyms such as 'golang'.

DimensionReasoningScore

Specificity

The description names the exact package ('github.com/ax-llm/ax/packages/go') and enumerates ten concrete capability areas — 'agents, child delegation, tools, MCP, citations, persistent playbook learning, stage instructions, runtime state, final typed responses, and direct-respond executor skipping' — comprehensively covering the skill's surface with no generic filler. Not 4: coverage has no notable gaps matching the body's scope.

5 / 5

Completeness

'Use when writing Go code with `github.com/ax-llm/ax/packages/go` for agents, child delegation...' explicitly answers 'when' with concrete triggers, and the 'what' is conveyed through the enumerated capabilities. Not 5: the 'what' is embedded in the when-clause rather than stated as an explicit capability sentence; not 3: both what and when are effectively present and concrete.

4 / 5

Trigger Term Quality

Natural terms users would say ('Go code', 'agents', 'tools', 'MCP', 'citations', 'child delegation') plus the distinctive import path give good keyword coverage. Not 5: misses natural synonyms and variants a user might say, such as 'golang', 'AxAgent', or 'Astra'.

4 / 5

Distinctiveness Conflict Risk

The specific package path and niche terms ('persistent playbook learning', 'direct-respond executor skipping') establish a clear, narrow domain with minimal risk of triggering for the wrong skill. Not 4: even closely related Go/MCP skills would not match these distinctive triggers.

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.