axx skills

Axx ships Agent Skills (SKILL.md + references) for Claude Code, Codex, Cursor, Gemini CLI, Copilot and other agents that read .agents/skills. The step references are generated from this project’s steps.

Usage:
  axx skills [command]

Available Commands:
  install     Install or update the skills (project: .agents/skills + .claude/skills)
  list        List the skills axx provides
  update      Update the skills this project and your home directory have to this axx's

Flags:
  -h, --help   help for skills

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)

Use "axx skills [command] --help" for more information about a command.

axx skills install

Write the skills to .agents/skills/ (read by Codex, Cursor, Gemini CLI and Copilot) and, when the project uses Claude Code (a .claude directory, CLAUDE.md or .mcp.json), link them into .claude/skills/ for it: –claude links them anyway, –no-claude never. In a project they also go in its .gitignore: Axx generates them, and each person or agent installs them, unless the repository holds them already. Re-running updates them; files you edited are kept unless –force.

Usage:
  axx skills install [flags]

Flags:
      --claude               link into .claude/skills even if the project does not use Claude Code
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
      --force                overwrite skill files you edited
  -h, --help                 help for install
      --no-claude            do not link into .claude/skills
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --scope string         project (this repo) or user (your home directory) (default "project")
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)

axx skills list

List the skills Axx provides

Usage:
  axx skills list [flags]

Flags:
  -h, --help   help for list

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)

axx skills update

Update the skills where they are installed: this project’s and your home directory’s. Files you edited are kept unless –force. axx upgrade does this after it replaces Axx. Skills that are not installed stay so: axx skills install adds them.

Usage:
  axx skills update [flags]

Flags:
  -D, --define stringArray   set a property for ${sys:name}, e.g. -D local.host=docker
      --force                overwrite skill files you edited
  -h, --help                 help for update
      --profile string       apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
      --set stringArray      set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value

Global Flags:
      --compact         print only what matters (auto-enabled for coding agents)
  -c, --config string   path to axx.yaml (default: search upward from the working directory)
      --json            emit machine-readable JSON (stable envelope)
      --no-color        disable colored output
  -v, --verbose count   increase log verbosity (-v, -vv)