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

# masterskills list / search

> The skill catalog across all your organizations, merged with local install state.

```bash theme={"dark"}
masterskills list [query]      # everything, optionally filtered
masterskills search <query>    # same command, query required
```

Lists skills across **all** organizations you belong to — name, version, visibility, install count — merged with this machine's state: which are installed, at what version, and whether an update is available.

## Options

| Option   | Effect                                      |
| -------- | ------------------------------------------- |
| `--json` | Machine-readable output — what agents parse |

## JSON shape

```json theme={"dark"}
{
  "skills": [
    {
      "name": "@acme/api-conventions",
      "org": "acme",
      "slug": "api-conventions",
      "displayName": "API conventions",
      "description": "REST and error-shape rules for all Acme services",
      "visibility": "private",
      "isRequired": false,
      "latestVersion": { "number": 4, "contentHash": "…", "sizeBytes": 34816, "fileCount": 6 },
      "installCount": 12,
      "installedVersion": 3,
      "updateAvailable": true
    }
  ]
}
```

`installedVersion` is absent for skills not on this machine. Kits are listed by [`masterskills kit list`](/cli/kit), not here.