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

# gaal audit

> Read-only scan of skills and MCP entries already on this machine.

```bash theme={"theme":"nord"}
gaal audit [flags]
```

Scans the filesystem for skills and MCP server entries that already exist, without writing anything. The output is the input `gaal init --import-all` uses to build a `gaal.yaml`, so running `audit` first is a great way to preview what an import would capture.

## What it scans

For each agent in the registry:

* **Project skill directories**, relative paths configured in the registry (e.g. `.claude/skills`, `.agents/skills`, `.github/skills`).
* **Global skill directories**, home-relative paths (e.g. `~/.claude/skills`, `~/.cursor/skills`).
* **Package-manager paths**, vendor-specific extension directories (e.g. `~/.cursor/extensions`, `~/.claude/plugins/cache`).
* **MCP config files**, every target file the agent uses.

## Flags

Only the [global flags](https://docs.getgaal.com/cli/overview.md#global-flags). `-o json` is useful for scripting.

## Sample output

```text theme={"theme":"nord"}
$ gaal audit
discovered:
  skills (project)
    .claude/skills/code-review     (claude-code)
    .cursor/skills/test-writer     (cursor)
  skills (global)
    ~/.claude/skills/git-helper    (claude-code)
    ~/.cursor/skills/refactor      (cursor)
  skills (package manager)
    ~/.claude/plugins/cache/extra-skill (claude-code)
  mcps
    ~/.claude.json
      filesystem, git, github
    ~/.cursor/mcp.json
      filesystem
```

## JSON output

```bash theme={"theme":"nord"}
gaal audit -o json
```

Returns the discovered skills and MCP entries as structured JSON.

## What audit does NOT do

* It doesn't write to `gaal.yaml`. Use `gaal init --import-all` for that.
* It doesn't reach the network. All discovery is filesystem-only.
* It doesn't read the contents of `SKILL.md` files, it only confirms the directory exists.

## Related

> [card] [gaal init](https://docs.getgaal.com/cli/init.md)

> [card] [First-time setup](https://docs.getgaal.com/workflows/first-time-setup.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.