Installation
Codex
Register Axiom's marketplace so Codex can find its plugins:
codex plugin marketplace add axiomhq/skills
Install the Axiom plugin, which includes all skills in this repository and the hosted MCP server connection:
codex plugin add axiom@axiom
In axiom@axiom, the first name is the plugin and the second is the marketplace.
Authorize Axiom in your browser when prompted. If you already added Axiom MCP manually, keep one connection to avoid duplicate tools.
To update, run codex plugin marketplace upgrade axiom, then codex plugin add axiom@axiom. Start a new session to use the update.
Claude Code
claude plugin marketplace add axiomhq/skills
claude plugin install axiom@axiom
Restart Claude Code, then use /mcp to authorize Axiom.
To update, run claude plugin marketplace update axiom, then claude plugin update axiom@axiom. Restart Claude Code to load it.
Cursor
On Teams or Enterprise, an admin must enable Allow Local Plugin Imports. Then clone into Cursor's local plugin directory:
git clone https://github.com/axiomhq/skills.git ~/.cursor/plugins/local/axiom
Reload Cursor and authorize Axiom when prompted. To update an existing install, run git -C ~/.cursor/plugins/local/axiom pull --ff-only, then reload Cursor.
Teams and Enterprise admins can also import axiomhq/skills through Plugins & MCPs → Add Marketplace → Import from Repo in the Cursor dashboard. See Cursor's plugin guide.
Gemini CLI
gemini extensions install https://github.com/axiomhq/skills
Restart Gemini CLI, then use /mcp auth axiom to authorize Axiom.
To update, run gemini extensions update axiom, then restart Gemini CLI. See the Gemini extension reference.
Skills installer
npx skills add axiomhq/skills
This installs all skills. Skills have dependencies on each other (e.g., axiom-controlling-costs depends on axiom-sre and axiom-building-dashboards), so installing all is recommended.
For SRE, run scripts/init from the installed skill directory; its location depends on your agent or plugin installer. From a checkout of this repository:
./skills/sre/scripts/init
This initializes SRE configuration and memory under ~/.config/axiom-sre/. Edit the generated config.toml to add your deployments, then run the initializer again. See SRE setup for configuration and migration from ~/.axiom.toml.