ax-agent-context
This skill helps an LLM pick the right AxAgent context tool for a job - contextMap for recurring corpora, contextPolicy presets for within-run trajectory compaction, agent.optimize for offline GEPA instruction/demo tuning, agent.playbook for an evolving context playbook (offline evolve + online update), and recall/memories + skills for per-turn retrieval. Use when the user asks "which context feature should I use", confuses contextMap with contextPolicy or memory, or wants a decision guide for long-context agents. For contextPolicy/contextMap codegen use ax-agent-rlm; for recall/skills use ax-agent-memory-skills; for agent.optimize or agent.playbook use ax-agent-optimize.
79
100%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
AxAgent Context Selection (@ax-llm/ax)
Use this skill to route a context-management need to the right AxAgent tool, then open the matching codegen skill. AxAgent manages four distinct context objects; choosing the wrong one is the usual mistake. Do not write tutorial prose; pick the tool and hand off.
Pick The Right Context Tool
| Need | Object | Scope | Use | Next skill |
|---|---|---|---|---|
| Many tasks over the same large corpus (repo, doc set, dataset) | Context map | recurring corpus, persists across runs | contextMap | ax-agent-rlm |
| One long run whose own history must stay under control | Trajectory compaction | this run only | contextPolicy: { preset, budget } | ax-agent-rlm |
| Evolve task strategy from examples or live feedback | Context playbook | a stage, offline + online | agent.playbook(...) | ax-agent-optimize |
| Tune the prompt/instructions/demos offline | Instruction text | a program, offline | agent.optimize(...) (GEPA) | ax-agent-optimize |
| Pull task-relevant facts or guides for a turn | Retrieval | one turn | recall(...) / skills | ax-agent-memory-skills |
Defaults
- Recurring corpus + many different questions ->
contextMap(persistent orientation cache). - One long multi-turn run with prompt pressure ->
contextPolicy: { preset: 'checkpointed', budget: 'balanced' }; move toleanfor very long runs with strong models,fullfor short tasks or weak models. - Evolve a context playbook ->
agent.playbook(...)(offline from examples, or online from live feedback). - Tune instructions/demos offline ->
agent.optimize(...)(GEPA). - Fetch facts or guides on demand ->
recall(...)for memories,discover({ skills })for skill guides. - A single oversized input value (a pasted doc, a big JSON blob) -> do nothing;
autoUpgrade(ON by default) keeps it runtime-only with a prompt preview. Reach forcontextFieldsonly when you want a specific inline policy or the value is a large required non-string field. Seeax-agent-rlm.
Anti-Patterns
- Do not use
contextMapto compress a single run's history. That iscontextPolicy. - Do not use
contextPolicyto carry knowledge across runs. That iscontextMap. - Do not hand-build a strategy playbook in the prompt. Evolve it with
agent.playbook(...). - Do not stuff a whole corpus into the prompt every run. Use a context map plus on-demand
recall(...). - Do not confuse runtime skills (
discover({ skills })guides) with these installable codegen skills.
See Also
ax-agent-rlm- contextPolicy presets, context maps, and runtime sessions.ax-agent-memory-skills- recall, memories, and dynamic skill loading.ax-agent-optimize- GEPA viaagent.optimize(...)and the context playbook viaagent.playbook(...).ax-agent- core agent shape and the final/clarification protocol.
- Last updated
- First committed
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.