CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ax-agent-memory-skills

This skill helps an LLM generate correct AxAgent memory retrieval, context-map, and dynamic skill-loading code using @ax-llm/ax. Use when the user asks about contextMap, AxAgentContextMap, onMemoriesSearch, memoriesCatalog, recall(...), inputs.memories, onLoadedMemories, onUsedMemories, onSkillsSearch, skillsCatalog, AxAgentCatalogSkill, discover({ skills }), onLoadedSkills, onUsedSkills, preloaded skills, preloading memories at forward time, relevanceRanking hints, loaded memory/skill IDs, or carrying memories across forward() calls.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a highly actionable, accurate API-contract skill: executable code for every feature, explicit turn-by-turn sequencing, and zero filler or generic explanation. Its weaknesses are repetition and an A/B-statistics digression that cost tokens, and the absence of any bundle structure — the whole 440-line reference is inlined where per-feature reference files would keep SKILL.md an overview.

Suggestions

Split the per-feature detail into one-level-deep reference files (e.g., references/memory-search.md, references/skills-search.md, references/context-map.md, references/types.md) and keep SKILL.md as a defaults/overview with clearly signaled links, so the full API reference is not loaded on every invocation.

State each contract once: the 'returns void' rule and the no-loop/no-Promise.all rule each appear in both a Rules list and the Do Not Generate section — consolidate them into one canonical location.

Trim the relevanceRanking A/B-gate statistics sentence to a one-line outcome ('enabled by default after A/B validation improved lookup precision and answer accuracy') — the per-model run counts and percentages are justification, not guidance.

DimensionReasoningScore

Conciseness

The body is dense with non-inferable contract detail (stage visibility, dedup/sort order, callback precedence, catalog vs callback semantics) and explains nothing Claude already knows, but it repeats itself — "both return `void`" appears in roughly four places, the no-loop/no-Promise.all rule appears twice, and the A/B-gate statistics sentence ("49 runs per variant per model: 24%→90% ... 63%→88%") is justification detail that earns no tokens. This matches level 4 (efficient with minor over-explanation that could be trimmed) rather than level 5's every-token-earns-its-place.

4 / 5

Actionability

Every feature ships complete, copy-paste-ready TypeScript: enabling onMemoriesSearch/onSkillsSearch, static catalogs, forward-time preloading, actor-side recall/discover turn usage, carrying memories across calls, relevanceRanking, and used-tracking, plus full type definitions and runnable example URLs. This matches level 5's fully executable coverage of the common cases.

5 / 5

Workflow Clarity

The enable → wire → actor-usage flow is unambiguous: 'Use These Defaults' acts as a decision procedure (catalog vs callback vs contextMap), actor usage is explicitly turn-sequenced ("Turn 1: kick off one batched lookup / Turn 2+: matched entries are now visible"), and a Do-Not-Generate section guards the failure modes. No destructive or batch operations are involved, so the validation cap does not apply, and the sequencing is explicit enough for level 5 rather than level 4's 'most checkpoints'.

5 / 5

Progressive Disclosure

No bundle files exist, and the entire ~440-line API reference — type definitions, per-option rule lists, cross-language persistence notes — is inlined in SKILL.md, matching level 3's 'content that should be separate is inline'. Headers are well organized and the example URLs are clearly signaled one level deep, which keeps it above level 2, but the placement gap is more than the 'minor organization gaps' of level 4 since effectively all detail lives in the main file.

3 / 5

Total

17

/

20

Passed

Description

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

The description is a strong trigger-focused spec: it states a concrete capability, uses third person, and backs an explicit 'Use when' clause with a near-exhaustive list of the API identifiers a user would actually mention. Its only weakness is that the 'what' compresses three feature areas under one action verb rather than listing multiple distinct actions.

DimensionReasoningScore

Specificity

The 'what' is concrete — "generate correct AxAgent memory retrieval, context-map, and dynamic skill-loading code using @ax-llm/ax" names three capability areas plus the package — but the single composite action verb "generate ... code" stops short of the multiple distinct actions in the level-5 anchor. It sits above level 3 because all three feature areas are explicitly named with only minor coverage gaps.

4 / 5

Completeness

Both questions are answered explicitly: a clear 'what' ("generate correct AxAgent memory retrieval, context-map, and dynamic skill-loading code using @ax-llm/ax") and an explicit 'when' with concrete trigger phrases ("Use when the user asks about contextMap, ... recall(...), ... discover({ skills }), ..."). This mirrors the level-5 example structure exactly, and the missing-Use-when cap does not apply.

5 / 5

Trigger Term Quality

The "Use when the user asks about" clause enumerates essentially the full API surface (contextMap, onMemoriesSearch, memoriesCatalog, recall(...), inputs.memories, discover({ skills }), relevanceRanking hints, ...) alongside natural phrasings like "preloaded skills" and "carrying memories across forward() calls". A user needing this skill would say or paste exactly these identifiers, matching the comprehensive-synonyms level-5 anchor; no common variations are missing.

5 / 5

Distinctiveness Conflict Risk

The triggers are unique library-specific identifiers (AxAgentContextMap, recall(...), discover({ skills })) with a clear niche in @ax-llm/ax agent memory/skill loading, giving minimal conflict risk with generic or sibling skills. Level 5 fits; no broad or generic phrasing is present.

5 / 5

Total

19

/

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

Path

website/static/typescript/.well-known/agent-skills/ax-agent-memory-skills/SKILL.md

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.