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

# Vaardigheden

> Installeer en beheer Olostep-vaardigheden in je AI-coderingsagenten

Installeer Olostep-vaardigheidsmappen direct in je AI-coderingsagenten vanaf de opdrachtregel.

* Vaardigheden worden geplaatst in een canonieke opslagplaats (`~/.agents/skills`) en worden gesymlinkt of gekopieerd naar de vaardighedenmap van elke agent
* Volgt alle installaties in een lockfile op `~/.agents/.skill-lock.json`
* Werkt met Cursor, Claude, Codex, Windsurf, Continue, en meer

Deze functie is beschikbaar via de [Olostep CLI](/sdks/cli).

## De vaardigheden

`olostep add skills` installeert alle 13. Elk is een `SKILL.md` die je agent leest om te weten **wat** Olostep kan doen en **wanneer** het te gebruiken.

Vaardigheden werken samen met de [MCP-server](/integrations/mcp-server): de MCP-server geeft de agent de live *tools*, de vaardigheden geven het de *know-how* voor wanneer en hoe ze te gebruiken.

### Setup

Begin hier — leert de agent hoe de Olostep MCP-server te configureren.

| Vaardigheid | Wat het doet                                                            |
| ----------- | ----------------------------------------------------------------------- |
| `setup`     | Configureer de Olostep MCP-server zodat alle andere vaardigheden werken |

### Kern webgegevens

De belangrijkste Olostep-mogelijkheden — gebruik deze om je agent live webtoegang te geven.

| Vaardigheid      | Wat het doet                                                             |
| ---------------- | ------------------------------------------------------------------------ |
| `scrape`         | Zet één URL om in schone markdown / HTML / JSON / tekst                  |
| `search`         | Live webzoekopdracht — resultaten, antwoorden en in-site URL-ontdekking  |
| `answers`        | Geciteerde, gestructureerde antwoorden uit live webgegevens              |
| `crawl`          | Crawlt autonoom een hele site                                            |
| `map`            | Ontdek elke URL op een site                                              |
| `batch`          | Scrape tot 10.000 URL's parallel                                         |
| `extract-schema` | Scrape een pagina in gestructureerde JSON die overeenkomt met een schema |

### Bouwen & integreren

Voor agenten die ontwikkelaars helpen Olostep toe te voegen aan een codebase of bij te houden met API-wijzigingen.

| Vaardigheid    | Wat het doet                                           |
| -------------- | ------------------------------------------------------ |
| `integrate`    | Installeer automatisch de Olostep SDK in een project   |
| `docs-to-code` | Scrape API-documentatie en schrijf werkende code ervan |
| `migrate-code` | Lees een migratiehandleiding en update lokale code     |

### Onderzoek & debuggen

Voor agenten die onderzoek doen, beslissingen nemen of codefouten debuggen.

| Vaardigheid   | Wat het doet                                                  |
| ------------- | ------------------------------------------------------------- |
| `research`    | Geciteerd, vergelijkend webonderzoek voor een beslissing      |
| `debug-error` | Zoek een foutmelding op tegen live GitHub / SO / documentatie |

### Categorieën

Elke vaardigheid behoort tot een van de drie categorieën, die overeenkomen met de `--category` vlag:

* **`usage`** — gebruik Olostep's functies: `scrape`, `search`, `answers`, `crawl`, `map`, `batch`, `extract-schema`.
* **`build`** — installeer en integreer Olostep in een codebase: `setup` (configureer de MCP-server) en `integrate` (voeg de Olostep SDK toe aan een project).
* **`workflow`** — produceer een deliverable met Olostep: `research`, `docs-to-code`, `migrate-code`, `debug-error`.

Installeer slechts één categorie:

```bash theme={null}
olostep add skills --category usage      # kern webgegevens vaardigheden
olostep add skills --category build      # setup + integratie vaardigheden
olostep add skills --category workflow   # onderzoek + deliverable vaardigheden
```

### Gehoste kopieën

Elke geïnstalleerde vaardigheid verwijst ook naar zijn gehoste kopie op `https://www.olostep.com/skills/<name>/SKILL.md` — een agent met webtoegang kan de nieuwste versie ophalen (die mogelijk mogelijkheden bevat die sinds de installatie zijn toegevoegd) en valt anders terug op de lokale kopie. Blader door alle gehoste vaardigheden op [olostep.com/skills](https://www.olostep.com/skills/index.md).

## Installeren

```bash theme={null}
npm install -g olostep-cli

# Installeer alle 13 vaardigheden in elke gedetecteerde agent
olostep add skills

# Of gebruik het subcommando vaardigheden (alias)
olostep skills install
```

Of zonder de CLI te installeren:

```bash theme={null}
npx -y olostep-cli@latest add skills
```

## Algemeen gebruik

```bash theme={null}
# Installeer alle vaardigheden
olostep skills install

# Ververs / update naar de nieuwste versie
olostep skills update

# Bekijk wat er is geïnstalleerd en waar
olostep skills list

# Verwijder alle vaardigheden
olostep skills uninstall
```

Filter wat wordt geïnstalleerd:

```bash theme={null}
# Alleen kern webgegevens vaardigheden
olostep add skills --category usage

# Alleen setup + integratie vaardigheden
olostep add skills --category build

# Kies zelf
olostep add skills --skill scrape --skill search --skill setup

# Alleen specifieke agenten
olostep add skills --agent cursor --agent claude

# Machineleesbare output
olostep add skills --json
```

## Opties referentie

| Optie                               | Standaard                   | Beschrijving                                                              |
| ----------------------------------- | --------------------------- | ------------------------------------------------------------------------- |
| `--login`                           | —                           | Voer browserlogin uit voordat je installeert                              |
| `--source <path>`                   | CLI gebundelde vaardigheden | Vaardigheden bronmap                                                      |
| `--cli-local-dir <path>`            | CLI/vaardigheden            | Map waar bronvaardigheden worden gesynchroniseerd voor CLI-lokaal gebruik |
| `--agent <name>`                    | —                           | Richt je op een specifieke agent — herhaalbaar                            |
| `--all-agents` / `--no-all-agents`  | `--all-agents`              | Richt je op alle gedetecteerde agenten                                    |
| `--global` / `--no-global`          | `--global`                  | Installeer in globale agentvaardigheidsmappen                             |
| `--canonical-dir <path>`            | `~/.agents/skills`          | Canonieke opslaglocatie                                                   |
| `--agent-skills-dir <path>`         | —                           | Aangepaste doelmap (vereist `--no-global`)                                |
| `--skill <name>`                    | —                           | Alleen deze vaardigheid opnemen — herhaalbaar                             |
| `--exclude <name>`                  | —                           | Sluit deze vaardigheid uit — herhaalbaar                                  |
| `--category`                        | —                           | `usage`, `build`, of `workflow`                                           |
| `--overwrite` / `--no-overwrite`    | `--overwrite`               | Vervang bestaande installaties                                            |
| `--link-mode <auto\|symlink\|copy>` | `auto`                      | `auto` probeert eerst symlink, valt terug op kopiëren                     |
| `--json`                            | —                           | Machineleesbare JSON-output                                               |

<Note>
  **Validatieregels:**

  * `--link-mode` moet `auto`, `symlink`, of `copy` zijn
  * `--agent-skills-dir` vereist `--no-global`
  * `--no-global` vereist `--agent-skills-dir`
  * Onbekende agentnamen zullen een fout geven
  * Een lege vaardigheidsselectie na `--skill` / `--exclude` zal een fout geven
</Note>

### JSON output vorm

Wanneer `--json` wordt doorgegeven, ziet de output er als volgt uit:

```json theme={null}
{
  "sync": {
    "plugin_source_dir": "/path/to/CLI/skills",
    "cli_local_dir": "/path/to/CLI/skills"
  },
  "selected_skills": ["scrape", "search"],
  "canonical_dir": "~/.agents/skills",
  "lockfile_path": "~/.agents/.skill-lock.json",
  "installed": [
    {
      "skill": "scrape",
      "canonical_path": "~/.agents/skills/olostep-scrape",
      "targets": [
        { "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
        { "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
      ]
    }
  ]
}
```

## Ondersteunde agenten

| Agent    | Sleutel    |
| -------- | ---------- |
| Cursor   | `cursor`   |
| Claude   | `claude`   |
| Codex    | `codex`    |
| Windsurf | `windsurf` |
| Continue | `continue` |
| Augment  | `augment`  |
| Roo      | `roo`      |
| Gemini   | `gemini`   |
| Copilot  | `copilot`  |
| Factory  | `factory`  |

Gebruik `--all-agents` (de standaard) om je op alle gedetecteerde agenten te richten, of `--agent <key>` voor specifieke.

## `olostep list skills`

Bekijk welke vaardigheden zijn geïnstalleerd en in welke agenten — zonder door bestanden te graven.

```bash theme={null}
olostep list skills            # mensleesbare samenvatting
olostep list skills --json     # machineleesbaar
```

## `olostep remove skills`

Verwijdert door Olostep geïnstalleerde vaardigheidsmappen uit de canonieke opslag en agentvaardigheidsmappen, en ruimt de lockfile op.

```bash theme={null}
# Verwijder alle Olostep-vaardigheden uit alle agenten
olostep remove skills

# Verwijder een specifieke vaardigheid
olostep remove skills --skill research

# Verwijder alleen van een specifieke agent
olostep remove skills --agent cursor

# Machineleesbare JSON-output
olostep remove skills --json
```

| Optie                              | Standaard          | Beschrijving                                                  |
| ---------------------------------- | ------------------ | ------------------------------------------------------------- |
| `--agent <name>`                   | —                  | Verwijder alleen van opgegeven agent(en) — herhaalbaar        |
| `--all-agents` / `--no-all-agents` | `--all-agents`     | Richt je op alle gedetecteerde agenten                        |
| `--canonical-dir <path>`           | `~/.agents/skills` | Canonieke vaardighedenmap om uit te verwijderen               |
| `--agent-skills-dir <path>`        | —                  | Aangepaste doelvaardighedenmap voor verwijdering              |
| `--skill <name>`                   | —                  | Verwijder alleen overeenkomende vaardigheid(en) — herhaalbaar |
| `--json`                           | —                  | Machineleesbare JSON-output                                   |

<Note>
  **Veiligheid:** Alleen mappen met het `olostep-` voorvoegsel worden aangeraakt. Niet-Olostep vaardigheidsmappen in agentmappen worden nooit gewijzigd. Lockfile-opruiming verwijdert alleen sleutels met het `olostep-` voorvoegsel.
</Note>

## Vaardigheidsontdekking en formaat

Vaardigheden worden ontdekt door submappen te scannen op een `SKILL.md` bestand. Het bestand moet een YAML frontmatter blok bevatten met `name` en `description` velden. Duplicaten van gesaneerde namen worden afgewezen.

```markdown theme={null}
---
name: my-skill
description: Wat deze vaardigheid doet en wanneer te gebruiken
---

# Mijn Vaardigheid

...vaardigheidsinstructies hier...
```

## Naamgevingsconventie

Geïnstalleerde mappen gebruiken altijd het `olostep-` voorvoegsel — bijvoorbeeld `research` wordt `olostep-research`. Namen worden gesaneerd naar kleine letters met ongeldige tekens vervangen door `-`. Dit voorvoegsel houdt Olostep-beheerde vaardigheden duidelijk herkenbaar en voorkomt conflicten met andere tools.

## Gerelateerd

* [CLI-referentie](/sdks/cli) — volledige commando documentatie
* [MCP Server](/integrations/mcp-server) — geef je agent live Olostep tools