CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-go-playbook

Use when writing Go code with `github.com/ax-llm/ax/packages/go` for the playbook() context-engineering surface, agent-bound verified evolution, run-end learning, online updates, and rendering a playbook into a program.

60

Quality

76%

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

Quality

Content

65%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-organized reference-style skill with genuine project-specific facts and good structure, but weak on executable guidance: the sole code snippet is a non-runnable sketch and it contradicts the API surface section on the package prefix, and no validation or verification steps are sequenced for the evolve/learn workflow.

Suggestions

Reconcile the package prefix between the Core Pattern (`ax.NewAx`, `ax.Playbook`) and the Relevant API Surface (`axllm.Playbook`, `axllm.Optimize`) — pick one import prefix and show the import statement so the snippet can be copied correctly.

Make the Core Pattern runnable: define or annotate the `llm`, `examples`, and `metricFn` inputs (e.g., point to the specific `examples/` file that supplies them) so the snippet goes from a shape sketch to copy-paste-ready guidance.

Add explicit ordering and verification to the evolve workflow — number the steps (grow → attach → evolve → verify/rollback → refine) and name the rollback/verification checkpoint the agent should hit before proceeding, rather than leaving the sequence implicit in the When To Use bullets.

DimensionReasoningScore

Conciseness

The body is lean with no explanation of concepts Claude already knows, and sections like Package Facts and Guardrails carry genuinely non-obvious, project-specific information. It sits at anchor 4 rather than 5 because the "When To Use" bullet list and intro largely restate the frontmatter description, which is already loaded with the skill and could be trimmed.

4 / 5

Actionability

The Core Pattern is real Go ("pb := ax.Playbook(program, ...)"; "pb.Evolve(ctx, examples, metricFn, nil)") but relies on undefined surrounding variables (llm, examples, metricFn), so it is a shape sketch rather than executable code. More importantly, the Core Pattern uses the `ax.` prefix while "Relevant API Surface" lists the same functionality as `axllm.Playbook`/`axllm.Optimize`, a concrete contradiction an agent could copy incorrectly — matching the anchor for concrete guidance with missing key details.

3 / 5

Workflow Clarity

A rough sequence is implied by the "When To Use" bullets (grow playbook → attach and learn from run-end signals → evolve → refine → render) plus the Core Pattern, but steps are not explicitly sequenced and validation checkpoints are absent — only the guardrail "Start from package examples for exact native syntax" serves as an implicit check. This matches the anchor for steps listed with missing or implicit checkpoints; it exceeds anchor 2 because a genuine sequence is discernible.

3 / 5

Progressive Disclosure

The body is under 50 lines, has no bundle files, and is organized into clear well-labeled sections (When To Use, Package Facts, Core Pattern, Relevant API Surface, Guardrails). Pointers to package-side detail (API.md, axir-api.json, examples/) are one level deep and clearly named, satisfying the simple-skill case for a top score.

5 / 5

Total

15

/

20

Passed

Description

78%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 with an explicit "Use when" trigger, a specific package path, and a multi-item capability list. Its main limitation is jargon-heavy phrasing ("context-engineering surface", "agent-bound verified evolution") that narrows natural trigger-term coverage and blurs the what/when split.

DimensionReasoningScore

Specificity

The description lists several concrete capabilities — "playbook() context-engineering surface, agent-bound verified evolution, run-end learning, online updates, and rendering a playbook into a program" — which matches the anchor for several specific actions with minor gaps. It falls short of the comprehensive anchor (5) because the actions are phrased in dense internal jargon rather than fully concrete terms, and above anchor 3 because more than 1-2 actions are named.

4 / 5

Completeness

An explicit "Use when..." trigger clause is present ("Use when writing Go code with `github.com/ax-llm/ax/packages/go` for..."), and the "what" is conveyed through the enumerated capability list. It matches anchor 4 — both what and when are present, but the "what" is folded into the when-clause and delivered in jargon rather than clearly and separately stated as the anchor-5 example does.

4 / 5

Trigger Term Quality

It includes natural terms a user of this package would actually say — "writing Go code", "playbook", the package import path "github.com/ax-llm/ax/packages/go" — giving good keyword coverage. It is below the comprehensive anchor (5) because synonyms and common variations (e.g., "ax", "context engineering", "optimize") are only partially covered.

4 / 5

Distinctiveness Conflict Risk

The description pins a specific package import path and a named API surface ("playbook()", "agent-bound verified evolution", "run-end learning") that belong to a clear niche, so it would rarely trigger for the wrong skill. This clearly matches the anchor for a clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

17

/

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.