# axx skills

> Install agent skills that teach coding agents to use Axx

Source: https://axx.nimbusxr.us/references/cli/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.

```text
Usage:
  axx skills [command]

Available Commands:
  install     Install or update the skills (project: .agents/skills + .claude/skills)
  list        List the skills axx provides

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 link them into .claude/skills/ for Claude Code. Re-running updates
them; files you edited are kept unless --force.

```text
Usage:
  axx skills install [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 install
      --no-claude            do not link into .claude/skills
      --profile string       apply profiles.<name> / axx.<name>.yaml (env: AXX_PROFILE)
      --scope string         project (this repo) or user (your home directory) (default "project")

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

```text
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)
```