CtrlK
BlogDocsLog inGet started
Tessl Logo

ax-agent

This skill helps an LLM generate correct core AxAgent code using @ax-llm/ax. Use when the user asks about agent(), child agents, namespaced functions, discovery mode, clarification, bubbleErrors, host-side final/clarification protocol, or ordinary agent runtime behavior. For MCP clients, native runtime modules, subscriptions, tasks, or authentication use ax-mcp alongside this skill. For RLM/code-runtime work use ax-agent-rlm; for callbacks and telemetry use ax-agent-observability; for recall/memory/skill loading use ax-agent-memory-skills; for agent.optimize(...) use ax-agent-optimize.

65

Quality

82%

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

71%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.

Highly actionable content with comprehensive executable TypeScript patterns and clear decision guidance, undermined by monolithic length, literal rule duplication across sections, and reference-grade detail (language tables, auto-upgrade internals, event-driven wake flows) inlined where separate reference files should carry it. The skill's own delegation discipline toward sibling skills is excellent; it should apply the same split to its own body.

Suggestions

Deduplicate rules stated verbatim in multiple sections: the discovery-before-call rule appears in both 'Use These Defaults' (line 35) and 'Critical Rules' (line 56), and bubbleErrors guidance is repeated in 'Use These Defaults', 'Decision Guide', 'Critical Rules', and the 'Bubble Errors' section — consolidate each into one canonical location.

Split reference-grade material into files under references/ (e.g. references/learning-citations.md for the language-spelling table and playbook evolve details, references/auto-upgrade.md for threshold internals, references/event-driven.md for wake/webhook flows), keeping one-line pointers in SKILL.md — mirroring the delegation pattern already used for ax-mcp and ax-agent-rlm.

Tighten the dense run-on paragraphs (autoUpgrade at line 57, playbook at line 615, relevanceRanking at line 279) to a single rule plus one short example each, moving edge-case caveats to the new reference files.

DimensionReasoningScore

Conciseness

The body is dense rule-style with no tutorial padding ('Do not write tutorial prose unless the user explicitly asks for explanation') and complete executable examples, but at ~710 lines it contains literal duplication — the discovery rule appears identically in 'Use These Defaults' (line 35) and 'Critical Rules' (line 56), bubbleErrors guidance is repeated across three sections — and several run-on mega-paragraphs (autoUpgrade, playbook, relevanceRanking) that could be tightened. Anchor 3: mostly efficient but could be tightened; not 4 due to the duplicated rules, not 2 since nothing explains concepts Claude already knows.

3 / 5

Actionability

Every pattern ships a complete, copy-paste-ready TypeScript example (canonical agent, voice I/O, child agents, fn() tools, grouped modules, host-side protocol, clarification resume with getState/setState, bubbleErrors), plus exact API shapes like the discovery signatures and structured clarification payload rules. Fully executable and covering the common cases — anchor 5.

5 / 5

Workflow Clarity

A 'Decision Guide' maps user intent to agent shape before any code is written, a 'Do Not Generate' section lists anti-patterns, and the clarification section shows an explicit error-recovery loop (catch AxAgentClarificationError -> error.getState() -> agent.setState -> forward). As a codegen skill no validation checkpoints are required, but rules are scattered across four overlapping sections (Use These Defaults / Decision Guide / Critical Rules / per-section Rules), leaving minor sequencing gaps — anchor 4, not 5.

4 / 5

Progressive Disclosure

No references/, scripts/, or assets/ bundle exists; the entire surface is inlined in one ~710-line SKILL.md. Deep-dive material that clearly belongs in separate reference files is inline (the Learning/Citations language-spelling table, auto-upgrade threshold details, the event-driven/MCP-wake sections), though delegation to sibling skills is well signaled and full examples live behind external links. Anchor 3: some structure and clear delegation, but content that should be separate is inline; not 4 given no actual reference files exist.

3 / 5

Total

15

/

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 what and when clauses, concrete trigger terms, and unusually disciplined boundary delegation to five sibling skills. Minor room to widen trigger synonyms and enumerate a few more concrete actions on the what-side.

DimensionReasoningScore

Specificity

The what-side is a single action ('generate correct core AxAgent code using @ax-llm/ax') but it names several concrete entities and sub-capabilities: 'agent(), child agents, namespaced functions, discovery mode, clarification, bubbleErrors, host-side final/clarification protocol'. This lists several specific items with minor coverage gaps (anchor 4) rather than the comprehensive multi-action list of anchor 5, and clearly exceeds the 1-2 concrete actions of anchor 3.

4 / 5

Completeness

It explicitly answers both what ('This skill helps an LLM generate correct core AxAgent code using @ax-llm/ax') and when ('Use when the user asks about agent(), child agents, ... or ordinary agent runtime behavior') with concrete trigger phrases, exactly matching anchor 5.

5 / 5

Trigger Term Quality

Triggers are natural phrases a user working with this library would say: 'agent()', 'child agents', 'discovery mode', 'clarification', 'bubbleErrors', 'ordinary agent runtime behavior'. Good keyword coverage, though a few natural synonyms are missing (e.g. 'AxAgent functions', 'tool functions', 'multi-agent'). Fits anchor 4, not 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (core AxAgent codegen) and explicitly delegates neighboring domains to other skills ('use ax-mcp', 'ax-agent-rlm', 'ax-agent-observability', 'ax-agent-memory-skills', 'ax-agent-optimize'), minimizing wrong-skill triggering. Matches anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (711 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

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.