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

# Default Skills

> Choose which default skills Vantage 3.0 self-hosted installs, find the skill IDs for your chart version, and add skills after installation.

Default skills are the built-in, read-only skills in the Vantage Skill Catalog. A Vantage release includes about 100 default skills, many with several versions, and installing every version can take an hour or more. The `defaultSkills` values of the `vantage-selfhosted` chart control which skills and versions are installed.

> [!WARNING]
>
> Installed default skills can't be removed. Removing a skill or version from your values leaves it installed, so choose the skill set before the first installation. Every later change can only add skills.

## Choose a mode

Set `defaultSkills.mode` to one of the following:

| `defaultSkills.mode` | Installs |
| - | - |
| `all` (default) | Every version of every default skill. |
| `minimal` | The newest version of each default skill, plus any additional versions pinned in the chart. |
| `custom` | Only the skills listed in `defaultSkills.skills`. |

The default is `all` because a skill built from a default skill stops working if that default skill isn't installed. Use `minimal` or `custom` only when you know which default skills your skills depend on.

> [!NOTE]
>
> `vantage.minimalInstall` controls workload sizing only and doesn't change the skill set. Before release 2026.10.16, `minimalInstall: true` also installed only the newest version of each skill. If you run a minimal installation, set `defaultSkills.mode: minimal` before you upgrade to keep the smaller skill set. If `minimalInstall` is `true` and `defaultSkills.mode` is `all`, the chart prints a warning when you install or upgrade.

## Find skill IDs

The `custom` mode identifies skills by ID. Each release lists its skills, IDs, and versions on its own default skills page. To find yours, open your release in [Releases](https://docs.abbyy.com/vantage/self-hosted/v3.0/reference/releases.md).

The skills, IDs, and versions can differ between releases. Each `vantage-selfhosted` chart includes the catalog for its release in `files/default-skills.yml`, so you can also read it from the chart you install. To print it, pull the chart and extract the file:

```bash theme={null}
helm pull $chart_uri/vantage-selfhosted --version $selfhosted_version
tar -xzOf vantage-selfhosted-$selfhosted_version.tgz vantage-selfhosted/files/default-skills.yml
```

Each entry lists the skill's ID, name, and available versions:

```yaml theme={null}
defaultSkills:
  - id: "3c1895c7-3f4b-481d-bee0-3e64e56f0968"
    name: "Air Waybill"
    versions: [5, 6, 10, 13, 15, 21, 22, 23, 24, 26]
```

`$chart_uri` and `$selfhosted_version` follow the conventions in [Install variables](https://docs.abbyy.com/vantage/self-hosted/v3.0/providers/azure.md#install-variables).

## Install a custom selection

List the skills to install under `defaultSkills.skills`, using IDs from the catalog:

```yaml theme={null}
defaultSkills:
  mode: custom
  skills:
    - id: 3c1895c7-3f4b-481d-bee0-3e64e56f0968 # Air Waybill, newest version
    - id: 1c9fe877-bf57-4452-952d-23ff97f58278 # Commercial Invoice, versions 22 and 25
      versions: [22, 25]
    - id: 7eed0b97-0dc1-4b0a-9ad3-795ae600578f # Credit Bureau Report, every version
      versions: all
```

* `versions` is optional. If you omit it, the newest version in the catalog is installed. Set it to `all` to install every version in the catalog, or to a list to install only those version numbers.
* An ID or version that isn't in the catalog fails the chart render, so a wrong value is caught when you install or upgrade.
* An empty `skills` list installs no default skills.
* A Process skill references other skills. If you include one, also include every skill it references.

## Add skills after installation

**1. Update your values and upgrade the chart**

Add the skills to `defaultSkills.skills`, or change `defaultSkills.mode`, and run `helm upgrade` on the `vantage-selfhosted` release.

**2. Trigger a sync**

A values change alone doesn't trigger a sync. Annotate the `Vantage` resource to reprocess it:

```bash theme={null}
kubectl -n $install_namespace annotate vantages.vantage.abbyy.com/$release_name \
  vantage.abbyy.com/reprocess="$(date +%s)" --overwrite
```

The operator runs the OCI migration again, regenerates the workloads, and updates the default skill installation. Only the versions that aren't installed yet are installed, and artifacts already in your destination registry aren't copied again.

**3. Confirm the skills are installed**

The update can take a few minutes to reach the cluster. First confirm that the new skills appear in the `DefaultSkillInstallation` resource:

```bash theme={null}
kubectl -n $install_namespace get defaultskillinstallation \
  -o jsonpath='{.items[*].spec.defaultSkills[*].name}'
```

The resource's `Installed` condition can still show `True` from the previous selection, so `kubectl wait --for=condition=Installed` can pass too early. Instead, wait until the `Installed` condition's `observedGeneration` matches the resource's `metadata.generation`:

```bash theme={null}
until kubectl -n $install_namespace get defaultskillinstallation -o json | jq -e '
  (.items | length) > 0 and all(.items[];
    (.status.conditions // [] | map(select(.type == "Installed")) | first) as $c
    | $c.status == "True" and $c.observedGeneration == .metadata.generation)' >/dev/null; do
  sleep 30
done
```

## Known limitations

* **The selection doesn't shorten the OCI migration.** The OCI migration copies the images for every default skill version in every mode. Choosing fewer skills shortens the installation, but not the migration or the space used in your registry.
* **The selection exists only in chart values.** The `Vantage` resource doesn't carry it, so you can't change the skill set by editing the resource directly.
* **`Installed: True` describes the last installation.** It doesn't reflect skills deleted from the database or a restored database until the selection changes again. A failed installation isn't retried automatically. To retry it, change the selection or restart the skill installer operator.
* **Additional workloads metadata takes precedence.** A `workloadsConfigMap.additionalMetadata` entry that sets `charts.skill-installer-def-installation.values.defaultSkills` replaces the selection from `defaultSkills`. For more information, see [Additional workloads metadata](https://docs.abbyy.com/vantage/self-hosted/v3.0/performance/additional-workloads-metadata.md).

## What's next

> [card] [Helm chart reference](https://docs.abbyy.com/vantage/self-hosted/v3.0/reference/latest/helm-values.md)
>
> All `vantage-selfhosted` values and how to inspect them for your chart version.

> [card] [Lifecycle](https://docs.abbyy.com/vantage/self-hosted/v3.0/lifecycle.md)
>
> How the operator reconciles the `Vantage` resource, and how to force a retry.
