> ## Documentation Index
> Fetch the complete documentation index at: https://xerg.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill bundle

> Install the Xerg agent skill with one command, or find the bundled copy in the npm package.

Xerg keeps one canonical skill file. Codex, Cursor, Claude Code, Claude Desktop, Antigravity, and generic MCP clients use the same skill content; only their install or hosted MCP config differs.

## Install with one command

Give a terminal-capable agent this cold-fetch prompt:

```text theme={null}
set up https://xerg.ai/skill.md
```

The fetched file tells the agent to identify its host, ask before persistent installation, run `doctor`, and offer the first local audit without uploading automatically.

Install the skill into any agent that supports the Agent Skills standard:

```bash theme={null}
npx skills add xergai/skills
```

This pulls the skill from the public [xergai/skills](https://github.com/xergai/skills) repo and registers it with your agent. Then ask your agent to audit your AI spend.

## Canonical source

The source of truth is `skills/xerg/SKILL.md`, published to three places on every release: the public [xergai/skills](https://github.com/xergai/skills) GitHub repo, the ClawHub listing, and the npm package bundle. The public mirror is:

```text theme={null}
https://xerg.ai/skill.md
```

The same bytes are available through both discovery conventions:

```text theme={null}
https://xerg.ai/.well-known/agent-skills/index.json
https://xerg.ai/.well-known/skills/index.json
```

The v0.2.0 index includes a generated SHA-256 digest of the exact served bytes. The legacy index retains the `name`, `description`, and `files` shape used by Hermes.

## Bundled package path

The published `@xerg/cli` package also includes a portable copy for agent tools that import skills from disk.

Inside the installed npm package, the bundled copy lives at:

```text theme={null}
skills/xerg/SKILL.md
```

For a local project install, that usually resolves to:

```text theme={null}
node_modules/@xerg/cli/skills/xerg/SKILL.md
```

For a global install, the same file lives inside the global npm package directory instead.

## What this file is for

The skill describes how an agent should use Xerg well:

* when to reach for `doctor`, `audit`, `--compare`, and `--push`
* how to choose local, SSH, Railway, or multi-source audits
* how to interpret confirmed waste versus directional opportunities
* what to verify before finishing an audit task

## Registry metadata

The skill frontmatter declares the runtime surface that ClawHub and agent registries need to understand:

* `xerg` or `npx` as the CLI entry point
* `@xerg/cli` as the npm package source
* optional Xerg Cloud credentials and config paths for explicit hosted commands
* optional SSH, rsync, and Railway dependencies for remote OpenClaw audits

These declarations are intentionally broader than the default local audit path because the same skill also documents opt-in hosted sync and remote audit workflows.

## Important caveat

Installing `@xerg/cli` does not automatically register the bundled skill with every agent product. `npx skills add xergai/skills` handles registration for supported agents; otherwise copy or link the skill into that product's own skill directory or use its import flow.

Use [agent clients](/docs/agent-clients) for client-specific setup notes.