Installiere Olostep-Fähigkeitsordner direkt in deine KI-Coding-Agenten über die Befehlszeile.
- Installiert Olostep-Fähigkeiten in Agenten wie Cursor, Claude, Codex, Windsurf und mehr
- Fähigkeiten landen in einem kanonischen Speicher (
~/.agents/skills) und werden in das Fähigkeitenverzeichnis jedes Agenten verlinkt oder kopiert
- Verfolgt alle Installationen in einer Lockdatei unter
~/.agents/.skill-lock.json
Diese Funktion ist über die Olostep CLI verfügbar.
olostep add skills
Synchronisiert Fähigkeiten aus einem Quellverzeichnis in die CLI, installiert sie in den kanonischen Speicher und verteilt sie dann in das Fähigkeitenverzeichnis jedes Agenten.
Installiere die CLI
# Globale Installation
npm install -g olostep-cli
# Oder ohne Installation ausführen
npx -y olostep-cli@latest add skills
Verwendung
# Installiere alle Fähigkeiten in alle erkannten Agenten (Standard)
olostep add skills
# Zuerst authentifizieren, dann installieren
olostep add skills --login
# Bestimmte Agenten anvisieren
olostep add skills --agent cursor --agent claude
# Immer kopieren statt verlinken
olostep add skills --link-mode copy
# Maschinenlesbare JSON-Ausgabe
olostep add skills --json
Optionen
| Option | Standard | Beschreibung |
|---|
--login | — | Browser-Login vor der Installation ausführen |
--source <path> | CLI gebündeltes Fähigkeitenverzeichnis | Quellverzeichnis der Fähigkeiten |
--cli-local-dir <path> | CLI/skills | Verzeichnis, in dem Quellfähigkeiten für die lokale CLI-Nutzung synchronisiert werden |
--agent <name> | — | Einen bestimmten Agenten anvisieren — wiederholbar |
--all-agents / --no-all-agents | --all-agents | Wenn kein --agent gesetzt ist, werden alle erkannten installierten Agenten anvisiert |
--global / --no-global | --global | In bekannte globale Fähigkeitenverzeichnisse des Agenten installieren |
--canonical-dir <path> | ~/.agents/skills | Kanonischer Speicherort für Olostep-Fähigkeiten |
--agent-skills-dir <path> | — | Benutzerdefiniertes Zielverzeichnis für Fähigkeiten (erfordert --no-global) |
--skill <name> | — | Nur diese Fähigkeit einbeziehen — wiederholbar |
--exclude <name> | — | Diese Fähigkeit ausschließen — wiederholbar |
--overwrite / --no-overwrite | --overwrite | Bestehende Ziele ersetzen |
--link-mode <auto|symlink|copy> | auto | auto versucht Symlink, fällt auf Kopieren zurück |
--json | — | Maschinenlesbare JSON-Ausgabe erzeugen |
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
JSON-Ausgabe
{
"sync": {
"plugin_source_dir": "/path/to/CLI/skills",
"cli_local_dir": "/path/to/CLI/skills"
},
"selected_skills": ["research-agent"],
"canonical_dir": "~/.agents/skills",
"lockfile_path": "~/.agents/.skill-lock.json",
"installed": [
{
"skill": "research-agent",
"canonical_path": "~/.agents/skills/olostep-research-agent",
"targets": [
{ "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-research-agent" },
{ "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-research-agent" }
]
}
]
}
SKILL.md-Datei durchsucht werden. Die Datei muss einen Frontmatter-Block mit den Feldern name und description enthalten. Doppelte bereinigte Namen werden abgelehnt.
---
name: research-agent
description: Autonomer Forschungsagent für tiefgehende Webuntersuchungen
---
# Forschungsagent
...Anleitungen zur Fähigkeit hier...
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 |
--all-agents (Standard), um alle erkannten installierten Agenten anzusprechen, oder übergebe --agent <key>, um bestimmte anzusprechen.
Namenskonvention
Installierte Ordnernamen verwenden immer das Präfix olostep-: z.B. wird research-agent zu olostep-research-agent. 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.
olostep remove skills
Entfernt von Olostep installierte Fähigkeitsordner aus dem kanonischen Speicher und den Agentenfähigkeitsverzeichnissen und bereinigt die Lockdatei.
Verwendung
# Entferne alle Olostep-Fähigkeiten von allen Agenten
olostep remove skills
# Eine bestimmte Fähigkeit entfernen
olostep remove skills --skill research-agent
# Nur von einem bestimmten Agenten entfernen
olostep remove skills --agent cursor
# Maschinenlesbare JSON-Ausgabe
olostep remove skills --json
Optionen
| Option | Standard | Beschreibung |
|---|
--agent <name> | — | Nur von angegebenen Agenten entfernen — wiederholbar |
--all-agents / --no-all-agents | --all-agents | Wenn kein --agent oder benutzerdefiniertes Verzeichnis, werden alle erkannten installierten Agenten verwendet |
--canonical-dir <path> | ~/.agents/skills | Kanonisches Fähigkeitenverzeichnis, aus dem entfernt werden soll |
--agent-skills-dir <path> | — | Benutzerdefiniertes Zielverzeichnis für die Entfernung |
--skill <name> | — | Nur übereinstimmende Fähigkeiten entfernen — wiederholbar |
--json | — | Maschinenlesbare JSON-Ausgabe erzeugen |
Sicherheit: Es werden nur Ordner mit dem Präfix olostep- berührt. Nicht-Olostep-Agentenordner werden nie modifiziert. Die Bereinigung der Lockdatei entfernt nur Schlüssel mit dem Präfix olostep-.
