> ## 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 update

> Check what changed in the registry and apply the updates you choose.

```bash theme={"dark"}
masterskills update --check          # show what would change; applies nothing
masterskills update                  # apply updates
masterskills update @acme/api-conventions   # limit to specific skills
```

## Options

| Option    | Effect                                                       |
| --------- | ------------------------------------------------------------ |
| `--check` | Report only — no writes                                      |
| `--json`  | Machine-readable output (with `--check`) — what agents parse |

## The three groups

A check reports every kind of drift between this machine and the registry:

```json theme={"dark"}
{
  "updates":     [{ "name": "@acme/api-conventions", "from": 3, "to": 4 }],
  "newRequired": [{ "name": "@acme/security-guidelines", "version": 2 }],
  "removed":     [{ "name": "@acme/legacy-deploy" }]
}
```

| Group         | Meaning                                          | Applied by                                                |
| ------------- | ------------------------------------------------ | --------------------------------------------------------- |
| `updates`     | Newer versions of installed skills               | `masterskills update`                                     |
| `newRequired` | Org-required skills missing from this machine    | [`masterskills add`](/cli/add) — after user consent       |
| `removed`     | Skills the org archived, still installed locally | [`masterskills remove`](/cli/remove) — after user consent |

Applying an update rewrites the skill in the central store, which refreshes every agent at once; downloads are hash-verified like installs. The check also reports this machine's installed skills to the registry, keeping panel install counts and the device's last-seen time accurate (see [`sync`](/cli/sync)).