Agent skill

Ax Agent Context

by dosco in dosco/aithy

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…

Apache-2.0Auto-check passedAgent Workflows

Install Ax Agent Context

skills CLI
$ npx skills add dosco/aithy --skill ax-agent-context -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dosco/aithy ax-agent-context --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dosco/aithy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ax-agent-context .claude/skills/ax-agent-context && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ax-agent-context
GitHub stars
107
Token cost
~903 tokens
SKILL.md length
363 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

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…

  • The user asks which context feature should I use
  • SKILL.md covers Pick The Right Context Tool, Defaults, Anti-Patterns and See Also
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Confuses contextMap with contextPolicy

What it does

Ax Agent Context is an agent skill from dosco/aithy. 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…

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Codebase knowledge for agents, Project scaffolding and Agent memory. The repository describes itself as: A personal AI agent that can work safely on your machine, remember useful context, and keep its data under your control. The licence is Apache-2.0.

When your agent uses it

  • The user asks which context feature should I use
  • Confuses contextMap with contextPolicy
  • Wants a decision guide for long-context agents

Example prompts

  • “which context feature should I use”
  • “/ax-agent-context”

What it can do on your machine

Read from SKILL.md and the folder at commit 0c9855f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ax Agent Context loads about 903 tokens when it runs. Until then it costs about 174 tokens; SKILL.md has 363 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~174
When it runs · the whole SKILL.md, loaded when a task matches
~903

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dosco/aithy at commit 0c9855f, republished under its Apache-2.0 licence (© dosco). 363 words, ~903 tokens.

Download SKILL.mdSave it as .claude/skills/ax-agent-context/SKILL.md (or your agent's skills folder).
name
ax-agent-context
description
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.
version
24.0.16

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

NeedObjectScopeUseNext skill
Many tasks over the same large corpus (repo, doc set, dataset)Context maprecurring corpus, persists across runscontextMapax-agent-rlm
One long run whose own history must stay under controlTrajectory compactionthis run onlycontextPolicy: { preset, budget }ax-agent-rlm
Evolve task strategy from examples or live feedbackContext playbooka stage, offline + onlineagent.playbook(...)ax-agent-optimize
Tune the prompt/instructions/demos offlineInstruction texta program, offlineagent.optimize(...) (GEPA)ax-agent-optimize
Pull task-relevant facts or guides for a turnRetrievalone turnrecall(...) / skillsax-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 to lean for very long runs with strong models, full for 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 for contextFields only when you want a specific inline policy or the value is a large required non-string field. See ax-agent-rlm.
Show full SKILL.md (105 more words)Show less

Anti-Patterns

  • Do not use contextMap to compress a single run's history. That is contextPolicy.
  • Do not use contextPolicy to carry knowledge across runs. That is contextMap.
  • 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 via agent.optimize(...) and the context playbook via agent.playbook(...).
  • ax-agent - core agent shape and the final/clarification protocol.

© dosco, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/ax-agent-context of dosco/aithy.

Open the folder on GitHubat commit 0c9855f

Compare with similar skills

Ax Agent Context next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ax Agent Context compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ax Agent Context this skilldosco/aithy107—~903Automated safety check: PassApache-2.0
Using LWC Memory and Graphssickn33/agentic-awesome-skills47k1 repos~2kAutomated safety check: PassApache-2.0
Nemo Rl Session MemoryNVIDIA/skills3.5k—~1.4kAutomated safety check: PassApache-2.0
Authoring Claude Mdsammcj/agentic-coding162—~2.6kAutomated safety check: PassApache-2.0
Project Context SetupMathews-Tom/armory328—~1.2kAutomated safety check: PassMIT
Kmp Starter MemoryDevAtrii/Kmp-Starter-Template167—~963Automated safety check: PassMIT

Similar skills

  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Agent WorkflowsAuto-check passed
  • Official

    Manage durable working-session memory for coding agents. An agent skill from NVIDIA/skills.

    3.5k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Authoring Claude Md

    sammcj/agentic-coding

    Creating and maintaining CLAUDE.md project memory files and .claude/rules/ rule files that provide non-obvious codebase context.

    162 GitHub stars~2.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Project Context Setup

    Mathews-Tom/armory

    Scaffolds per-repository agent context so coding agents share the same issue tracker rules, triage label vocabulary, domain glossary, ADR layout, and handoff conventions.

    328 GitHub stars~1.2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Kmp Starter Memory

    DevAtrii/Kmp-Starter-Template

    Persistent per-project memory for KMP Starter Template apps.

    167 GitHub stars~963 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Repo Scaffold

    majiayu000/spellbook

    Scaffold or standardize a production-ready repository structure with specs, source layout, tests, CI, agent context, config examples, release notes, and operational docs.

    286 GitHub stars~651 tokensUpdated today
    DevelopmentAuto-check passed

More from dosco/aithy

All 17 skills in this repo
  • This skill helps an LLM generate correct AxAgent observability code using @ax-llm/ax.

    107 GitHub stars~4.4k tokensUpdated 1 mo ago
    Auto-check passed
  • This skill helps an LLM generate correct AxAgent tuning and evaluation code using @ax-llm/ax.

    107 GitHub stars~4.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Ax Audio

    dosco/aithy

    This skill helps an LLM generate correct audio code with @ax-llm/ax.

    107 GitHub stars~2.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Ax Gepa

    dosco/aithy

    This skill helps an LLM generate correct AxGEPA optimization code using @ax-llm/ax.

    107 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Ax LLM

    dosco/aithy

    This skill helps with using the @ax-llm/ax TypeScript library for building LLM applications.

    107 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Ax MCP

    dosco/aithy

    This skill helps an LLM build correct native Model Context Protocol integrations with @ax-llm/ax.

    107 GitHub stars~4.4k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Ax Agent Context

What does Ax Agent Context do?

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…. Ax Agent Context is an agent skill from dosco/aithy.playbook for an evolving context playbook (offline evolve + online update), and recall/memories + skills for per-turn retrieval.

When should I use Ax Agent Context?

Ax Agent Context fits situations like: the user asks which context feature should I use; confuses contextMap with contextPolicy; wants a decision guide for long-context agents.

How do I install Ax Agent Context in Claude Code?

Run `npx skills add dosco/aithy --skill ax-agent-context -a claude-code`. Or copy the skill folder (.claude/skills/ax-agent-context in dosco/aithy) into .claude/skills/ax-agent-context in your project. Claude Code loads it when a task matches its description.

How do I install Ax Agent Context in Codex?

Run `npx skills add dosco/aithy --skill ax-agent-context -a codex`. Or copy the skill folder (.claude/skills/ax-agent-context in dosco/aithy) into .agents/skills/ax-agent-context in your project. Codex loads it when a task matches its description.

Can I use Ax Agent Context in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dosco/aithy --skill ax-agent-context -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ax-agent-context, .gemini/skills/ax-agent-context, .github/skills/ax-agent-context and .opencode/skills/ax-agent-context in your project.

What does Ax Agent Context need to run?

SKILL.md names no scripts, command-line tools or credentials: Ax Agent Context is instructions for the agent only.

Does Ax Agent Context access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ax Agent Context safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ax Agent Context use?

Ax Agent Context is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ax Agent Context use?

About 903 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ax Agent Context?

Skills that share tags, products or a category with Ax Agent Context: Using LWC Memory and Graphs (sickn33/agentic-awesome-skills, 47k stars), Nemo Rl Session Memory (NVIDIA/skills, 3.5k stars), Authoring Claude Md (sammcj/agentic-coding, 162 stars) and Project Context Setup (Mathews-Tom/armory, 328 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ax Agent Context?

dosco (a GitHub user) maintains it in dosco/aithy, which has 107 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on August 31, 2026.

Source: dosco/aithy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.