Skip to main content
skill CX Codex

setup · necmttn — Claude Code skill: what it does, how to install

Installs the ax environment, builds a local DuckDB session graph, and validates the agent configuration.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Necmttn/ax --skill setup -a claude-code
Open on GitHub

What setup does

The skill fetches install.sh into a temporary directory, presents it for review, and runs the script only after explicit confirmation. Next, it links axctl to ~/.local/bin/ax, adds ax skills to the coding agent, and executes ax ingest --since=7. That step ingests the last 7 days of agent transcripts into a local graph.

Storage runs on an embedded DuckDB file inside ~/.local/share/ax/. No background daemon stays in memory. Cache queries automatically trigger a background refresh when stale. The skill then runs ax doctor --json to verify the setup and prompts you to categorize untagged tools with ax skills classify. If $HOME/.local/bin is missing from PATH, shell sessions will fail to locate ax.

What it helps with

  • install the ax CLI and related agent skills
  • verify environment health using ax doctor
  • seed the DuckDB session graph with 7 days of history
  • assign functional roles to unclassified skills
  • review model spending breakdown across runs

Example prompts for the agent

  • Install and set up ax in Claude Code
  • ax not found, fix the installation
  • Run ax doctor to check the system

How to install setup

1Skills CLI (Vercel)

npx skills add Necmttn/ax --skill setup -a claude-code

2Manually: put the files in place

~/.claude/skills/setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about setup

How to install setup in Claude Code?

Run npx skills add Necmttn/ax --skill setup -a claude-code. The skill will be saved to ~/.claude/skills/setup/SKILL.md.

What is the purpose of the setup skill?

It automates installing ax, opens the installer for manual review, ingests recent agent sessions into an embedded DuckDB database, and validates everything with ax doctor.

Does ax require a persistent background daemon?

No, ax maintains its graph in an embedded DuckDB file at ~/.local/share/ax/. Commands update data on demand in the background, so no active service process needs to run.

Similar skills

All skills for Agent setup: memory, context, orchestration →

setup by other authors comes first.

setup Alireza Rezvani Sets up an autoresearch experiment by collecting its target file, evaluation command, metric, and optimization direction. Use it before starting an optimization loop. 1,480installs setup aws This skill kicks off the connection setup for AWS DevOps Agent and AWS Security Agent. Reach for it when MCP tools go missing or you are wiring the toolkit up for the first time. CX Codex +1 1,500installs setup marketcalls Sets up a Python backtesting environment with VectorBT and OpenAlgo. It configures the virtual environment, installs dependencies, and prepares .env. CX Codex +1 2,000installs setup assistant-ui This skill guides assistant-ui project creation, setup in an existing app, and runtime selection. Use it when starting a chat UI or wiring one to a backend. CX Codex +1 6,100installs setup aladicf Scans project files and asks UX questions to capture audience, brand personality, and UI defaults into .better-web-ui.md. CX Codex +1 605installs setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set11

ax-add-ingest-stage Guides the addition of SurrealDB tables and pipeline ingest stages in the ax repository. Keeps changes aligned with strict CI verification gates. CX Codex +1 ★ 121repo stars tune tune reviews one coding session and records proposed agent-environment changes in ax. Use it to trace tool errors, wasted calls, and missing checks. CX Codex +1 ★ 121repo stars ship-checklist A definition-of-done skill for the ax graph: it checks that a new write has a read path an agent can find, not just a manual CLI run. CX Codex +1 ★ 121repo stars retro Runs a guided session over the ax agent-experience graph. Shows open proposals, pending verdicts, and hook effectiveness signals. CX Codex +1 ★ 121repo stars release-announcement Drafts detailed release announcements and changelog pages for the ax project. It pairs Git commit ranges with agent session logs to explain why code changed. CX Codex +1 ★ 121repo stars ax-narrate This skill turns an agent’s current-session context into a structured story, including code changes, user corrections, abandoned approaches, and consequential tool errors. CX Codex +1 ★ 121repo stars efficient-dispatch A skill that keeps judgement work on the strong model, sends mechanical subagent tasks to a named cheaper model, and checks the routing against your own logs. CX Codex +1 ★ 121repo stars dojo Runs a background self-improvement loop using surplus model quota. It processes maintenance agendas in isolated worktrees via the ax tool. CX Codex +1 ★ 121repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor