AxAgent Memory And Skills Rules (@ax-llm/ax)

Use this skill when an agent needs a persistent context map, task-relevant memory retrieval, or skill guides loaded into the executor prompt on demand. For ordinary agent setup use ax-agent. For RLM runtime policy use ax-agent-rlm. For callbacks and telemetry use ax-agent-observability.

Use These Defaults

• Use a static skillsCatalog / memoriesCatalog when the skill guides or memories fit in a plain array — Ax then backs discover({ skills }) / recall(...) with a built-in deterministic local search and no host search code is needed.
• Use onSkillsSearch / onMemoriesSearch when retrieval needs a real backend (vector DB, BM25 service, KV). A host callback always takes precedence over the catalog's built-in search.
• Use contextMap when repeated runs inspect the same long external context and should accumulate a small orientation cache automatically.
• recall(...) is available to distiller and executor stages when onMemoriesSearch or a non-empty memoriesCatalog is set.
• discover({ skills }) is available to the executor when onSkillsSearch or a non-empty skillsCatalog is set.
• With skillsCatalog, the executor prompt also gains a static ### Available Skills index (id + name + description), so skill discovery is targeted instead of blind.
• Both recall(...) and discover({ skills }) return void. The loaded content appears on the next turn.
• Use onLoadedMemories / onLoadedSkills to observe what got loaded.
• Use onUsedMemories / onUsedSkills to track what the actor says it actually relied on.
• Child agents do not inherit memory or skills search callbacks; wire them explicitly on every agent that needs the capability.

Context Map