dojo — Claude Code skill: what it does, how to install
Runs a background self-improvement loop using surplus model quota. It processes maintenance agendas in isolated worktrees via the ax tool.
npx skills add Necmttn/ax --skill dojo -a claude-codeWhat dojo does
The skill directs leftover plan quota toward background upkeep tasks. It pulls items from ax dojo agenda --json, allowing the agent to resolve pending verdicts, backtest routing rules, and draft upstream bug reports. In Claude Code, the routine operates dynamically via /loop, while in Codex it runs as a single turn.
Safety rails prevent runaway edits. All code experiments run inside isolated git worktree directories. The agent cannot modify the main branch directly and never merges branches autonomously. Changes reach production only as minted proposals awaiting human review.
Running this loop requires the ax (axctl) binary on your system PATH. A dedicated database server is not needed because the storage layer relies on embedded DuckDB.
What it helps with
- consume surplus model quota on background evaluations
- backtest routing policies against dispatch history
- stage upstream bug drafts without publishing directly
- isolate experimental edits within disposable git worktrees
Example prompts for the agent
/dojo- Train overnight and burn my surplus quota
- Run the self-improvement loop with
/loop /dojo
How to install dojo
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill dojo -a claude-code2Manually: put the files in place
~/.claude/skills/dojo/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/dojo/
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill dojo -a codex2Manually: put the files in place
.agents/skills/dojo/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill dojo -a cursor2Manually: put the files in place
.cursor/skills/dojo/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax dojo2Manually: put the files in place
.github/skills/dojo/SKILL.md1Skills CLI (Vercel)
npx skills add Necmttn/ax --skill dojo -a gemini-cli2Platform CLI
gemini skills install https://github.com/Necmttn/ax --path skills/dojoManually: put the files in place
.devin/skills/dojo/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Necmttn/ax --skill dojo -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about dojo
How to install dojo in Claude Code?
Run npx skills add Necmttn/ax --skill dojo -a claude-code in your terminal.
What does the dojo skill do?
It spins up an autonomous agenda loop that consumes spare quota to optimize routing, settle verdicts, and propose workspace fixes.
What prerequisites does dojo require?
You must have the ax CLI (axctl) available on your PATH. It stores data in embedded DuckDB, so no standalone database daemon is required.