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

# Fähigkeiten

> Installiere und verwalte Olostep-Fähigkeiten in deinen KI-Coding-Agenten

Installiere Olostep-Fähigkeitsordner direkt in deine KI-Coding-Agenten über die Kommandozeile.

* Fähigkeiten landen in einem kanonischen Speicher (`~/.agents/skills`) und werden in das Fähigkeitenverzeichnis jedes Agenten symlinked oder kopiert
* Verfolgt alle Installationen in einer Sperrdatei unter `~/.agents/.skill-lock.json`
* Funktioniert mit Cursor, Claude, Codex, Windsurf, Continue und mehr

Diese Funktion ist über die [Olostep CLI](/sdks/cli) verfügbar.

## Die Fähigkeiten

`olostep add skills` installiert alle 13. Jede ist eine `SKILL.md`, die dein Agent liest, um zu wissen, **was** Olostep tun kann und **wann** es zu verwenden ist.

Fähigkeiten paaren sich mit dem [MCP-Server](/integrations/mcp-server): Der MCP-Server gibt dem Agenten die Live-*Tools*, die Fähigkeiten geben ihm das *Know-how*, wann und wie sie zu verwenden sind.

### Einrichtung

Starte hier — lehrt den Agenten, wie man den Olostep MCP-Server konfiguriert.

| Fähigkeit | Was sie tut                                                                       |
| --------- | --------------------------------------------------------------------------------- |
| `setup`   | Konfiguriert den Olostep MCP-Server, damit alle anderen Fähigkeiten funktionieren |

### Kern-Webdaten

Die Hauptfähigkeiten von Olostep — verwende diese, um deinem Agenten Live-Webzugriff zu geben.

| Fähigkeit        | Was sie tut                                                           |
| ---------------- | --------------------------------------------------------------------- |
| `scrape`         | Wandelt eine URL in sauberes Markdown / HTML / JSON / Text um         |
| `search`         | Live-Websuche — Ergebnisse, Antworten und In-Site-URL-Entdeckung      |
| `answers`        | Zitierte, strukturierte Antworten aus Live-Webdaten                   |
| `crawl`          | Durchsucht autonom eine ganze Website                                 |
| `map`            | Entdeckt jede URL auf einer Website                                   |
| `batch`          | Schabt bis zu 10.000 URLs parallel                                    |
| `extract-schema` | Schabt eine Seite in strukturiertes JSON, das einem Schema entspricht |

### Erstellen & Integrieren

Für Agenten, die Entwicklern helfen, Olostep in eine Codebasis einzufügen oder mit API-Änderungen Schritt zu halten.

| Fähigkeit      | Was sie tut                                                          |
| -------------- | -------------------------------------------------------------------- |
| `integrate`    | Installiert das Olostep SDK automatisch in ein Projekt               |
| `docs-to-code` | Schabt API-Dokumentationen und schreibt funktionierenden Code daraus |
| `migrate-code` | Liest einen Migrationsleitfaden und aktualisiert lokalen Code        |

### Forschen & Debuggen

Für Agenten, die Forschung betreiben, Entscheidungen treffen oder Codefehler debuggen.

| Fähigkeit     | Was sie tut                                                |
| ------------- | ---------------------------------------------------------- |
| `research`    | Zitierte, vergleichende Webforschung für eine Entscheidung |
| `debug-error` | Sucht eine Fehlermeldung in Live-GitHub / SO / Docs nach   |

### Kategorien

Jede Fähigkeit gehört zu einer von drei Kategorien, die der `--category`-Flag zugeordnet sind:

* **`usage`** — Verwende die Funktionen von Olostep: `scrape`, `search`, `answers`, `crawl`, `map`, `batch`, `extract-schema`.
* **`build`** — Installiere und integriere Olostep in eine Codebasis: `setup` (konfiguriere den MCP-Server) und `integrate` (füge das Olostep SDK zu einem Projekt hinzu).
* **`workflow`** — Erstelle ein Ergebnis mit Olostep: `research`, `docs-to-code`, `migrate-code`, `debug-error`.

Installiere nur eine Kategorie:

```bash theme={null}
olostep add skills --category usage      # Kern-Webdaten-Fähigkeiten
olostep add skills --category build      # Einrichtungs- + Integrationsfähigkeiten
olostep add skills --category workflow   # Forschungs- + Ergebnisfähigkeiten
```

### Gehostete Kopien

Jede installierte Fähigkeit verweist auch auf ihre gehostete Kopie unter `https://www.olostep.com/skills/<name>/SKILL.md` — ein Agent mit Webzugriff kann die neueste Version abrufen (die möglicherweise seit der Installation hinzugefügte Funktionen enthält) und greift andernfalls auf die lokale Kopie zurück. Durchsuche alle gehosteten Fähigkeiten unter [olostep.com/skills](https://www.olostep.com/skills/index.md).

## Installation

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

# Installiere alle 13 Fähigkeiten in jeden erkannten Agenten
olostep add skills

# Oder verwende den Fähigkeiten-Unterbefehl (Alias)
olostep skills install
```

Oder ohne die CLI zu installieren:

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

## Häufige Nutzung

```bash theme={null}
# Installiere alle Fähigkeiten
olostep skills install

# Aktualisiere auf die neueste Version
olostep skills update

# Sieh, was installiert ist und wo
olostep skills list

# Entferne alle Fähigkeiten
olostep skills uninstall
```

Filtere, was installiert wird:

```bash theme={null}
# Nur Kern-Webdaten-Fähigkeiten
olostep add skills --category usage

# Nur Einrichtungs- + Integrationsfähigkeiten
olostep add skills --category build

# Wähle gezielt aus
olostep add skills --skill scrape --skill search --skill setup

# Nur spezifische Agenten
olostep add skills --agent cursor --agent claude

# Maschinenlesbare Ausgabe
olostep add skills --json
```

## Optionsreferenz

| Option                              | Standard                   | Beschreibung                                                                          |
| ----------------------------------- | -------------------------- | ------------------------------------------------------------------------------------- |
| `--login`                           | —                          | Führe Browser-Login vor der Installation durch                                        |
| `--source <path>`                   | CLI gebündelte Fähigkeiten | Verzeichnis der Fähigkeitenquelle                                                     |
| `--cli-local-dir <path>`            | CLI/skills                 | Verzeichnis, in dem Quellfähigkeiten für die lokale CLI-Nutzung synchronisiert werden |
| `--agent <name>`                    | —                          | Zielagent anvisieren — wiederholbar                                                   |
| `--all-agents` / `--no-all-agents`  | `--all-agents`             | Alle erkannten Agenten anvisieren                                                     |
| `--global` / `--no-global`          | `--global`                 | In globale Agentenfähigkeitsverzeichnisse installieren                                |
| `--canonical-dir <path>`            | `~/.agents/skills`         | Kanonischer Speicherort                                                               |
| `--agent-skills-dir <path>`         | —                          | Benutzerdefiniertes Zielverzeichnis (erfordert `--no-global`)                         |
| `--skill <name>`                    | —                          | Nur diese Fähigkeit einbeziehen — wiederholbar                                        |
| `--exclude <name>`                  | —                          | Diese Fähigkeit ausschließen — wiederholbar                                           |
| `--category`                        | —                          | `usage`, `build` oder `workflow`                                                      |
| `--overwrite` / `--no-overwrite`    | `--overwrite`              | Bestehende Installationen ersetzen                                                    |
| `--link-mode <auto\|symlink\|copy>` | `auto`                     | `auto` versucht zuerst Symlink, fällt zurück auf Kopie                                |
| `--json`                            | —                          | Maschinenlesbare JSON-Ausgabe                                                         |

<Note>
  **Validierungsregeln:**

  * `--link-mode` muss `auto`, `symlink` oder `copy` sein
  * `--agent-skills-dir` erfordert `--no-global`
  * `--no-global` erfordert `--agent-skills-dir`
  * Unbekannte Agentennamen führen zu einem Fehler
  * Eine leere Fähigkeitsauswahl nach `--skill` / `--exclude` führt zu einem Fehler
</Note>

### JSON-Ausgabeform

Wenn `--json` übergeben wird, sieht die Ausgabe so aus:

```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" }
      ]
    }
  ]
}
```

## Unterstützte Agenten

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

Verwende `--all-agents` (Standard), um alle erkannten Agenten anzuvisieren, oder `--agent <key>` für spezifische.

## `olostep list skills`

Sieh, welche Fähigkeiten installiert sind und in welche Agenten — ohne in Dateien zu wühlen.

```bash theme={null}
olostep list skills            # Menschlich lesbare Zusammenfassung
olostep list skills --json     # Maschinenlesbar
```

## `olostep remove skills`

Entfernt von Olostep installierte Fähigkeitsordner aus dem kanonischen Speicher und den Agentenfähigkeitsverzeichnissen und bereinigt die Sperrdatei.

```bash theme={null}
# Entferne alle Olostep-Fähigkeiten von allen Agenten
olostep remove skills

# Entferne eine spezifische Fähigkeit
olostep remove skills --skill research

# Entferne nur von einem spezifischen Agenten
olostep remove skills --agent cursor

# Maschinenlesbare JSON-Ausgabe
olostep remove skills --json
```

| Option                             | Standard           | Beschreibung                                           |
| ---------------------------------- | ------------------ | ------------------------------------------------------ |
| `--agent <name>`                   | —                  | Nur von angegebenen Agenten entfernen — wiederholbar   |
| `--all-agents` / `--no-all-agents` | `--all-agents`     | Alle erkannten Agenten anvisieren                      |
| `--canonical-dir <path>`           | `~/.agents/skills` | Kanonisches Fähigkeitsverzeichnis zum Entfernen        |
| `--agent-skills-dir <path>`        | —                  | Benutzerdefiniertes Zielverzeichnis für die Entfernung |
| `--skill <name>`                   | —                  | Nur passende Fähigkeit(en) entfernen — wiederholbar    |
| `--json`                           | —                  | Maschinenlesbare JSON-Ausgabe                          |

<Note>
  **Sicherheit:** Nur Ordner mit dem Präfix `olostep-` werden berührt. Nicht-Olostep-Fähigkeitsordner in Agentenverzeichnissen werden nie modifiziert. Die Sperrdateibereinigung entfernt nur Schlüssel mit dem Präfix `olostep-`.
</Note>

## Fähigkeitsentdeckung und Format

Fähigkeiten werden durch Scannen von Unterverzeichnissen nach einer `SKILL.md`-Datei entdeckt. Die Datei muss einen YAML-Frontmatter-Block mit den Feldern `name` und `description` enthalten. Doppelte bereinigte Namen werden abgelehnt.

```markdown theme={null}
---
name: my-skill
description: Was diese Fähigkeit tut und wann sie zu verwenden ist
---

# Meine Fähigkeit

...Fähigkeitsanweisungen hier...
```

## Namenskonvention

Installierte Ordner verwenden immer das Präfix `olostep-` — z.B. wird `research` zu `olostep-research`. Namen werden in Kleinbuchstaben bereinigt, wobei ungültige Zeichen durch `-` ersetzt werden. Dieses Präfix hält Olostep-verwaltete Fähigkeiten klar erkennbar und verhindert Konflikte mit anderen Tools.

## Verwandt

* [CLI-Referenz](/sdks/cli) — vollständige Befehlsdokumentation
* [MCP-Server](/integrations/mcp-server) — gib deinem Agenten Live-Olostep-Tools
