OpenAI Skill Installer einrichten

Der Skill Installer installiert weitere OpenAI-Codex-Skills aus kuratierten Listen oder GitHub-Repositories in lokale Agenten-Workflows.

Veröffentlicht am 09.09.2026

Was ist der Skill Installer und wofür wird er gebraucht

Der Skill Installer ist eine Systemskill von OpenAI, die fest im Repository openai/skills unter dem Pfad skills/.system/skill-installer enthalten ist und standardmäßig mit dem Codex-CLI-Werkzeug von OpenAI ausgeliefert wird. Codex ist ein Kommandozeilen-Assistent von OpenAI für Programmieraufgaben, vergleichbar im Grundgedanken mit Claude Code, und verwendet ebenfalls ein Skill-System, bei dem einzelne Markdown-Dateien mit Anweisungen zusätzliches Wissen oder zusätzliche Fähigkeiten bereitstellen. Die Aufgabe des Skill Installers besteht darin, weitere Skills zu installieren, entweder aus der von OpenAI kuratierten Liste unter skills/.curated im selben Repository oder aus einem beliebigen anderen GitHub-Repository, einschließlich privater Repositories, wenn die entsprechenden Zugangsdaten vorhanden sind. Relevant ist die Skill für alle, die Codex mit zusätzlichen, community-basierten oder unternehmensinternen Fähigkeiten erweitern möchten, ohne Dateien manuell in das richtige Verzeichnis kopieren zu müssen.

Voraussetzungen

Da der Skill Installer bereits als vorinstallierte Systemskill Teil jeder Codex-Installation ist, braucht man zunächst nur eine funktionierende Codex-CLI-Installation. Für die Installation von Skills selbst ist Netzwerkzugriff erforderlich, weshalb die zugehörigen Hilfsskripte laut Dokumentation in einer Sandbox-Umgebung eine explizite Freigabe für Netzwerkzugriffe benötigen. Wer Skills aus privaten GitHub-Repositories installieren möchte, benötigt entweder bereits vorhandene Git-Zugangsdaten auf dem System oder eine Umgebungsvariable mit einem GitHub-Token, wahlweise GITHUB_TOKEN oder GH_TOKEN genannt.

Einrichtung Schritt für Schritt

Weil die Skill bereits vorinstalliert ist, entfällt ein separater Einrichtungsschritt für die Skill selbst; man nutzt sie direkt über eine Anfrage an Codex. Möchte man zunächst sehen, welche Skills verfügbar sind, lässt man sich die kuratierte Liste anzeigen, wobei das zugrunde liegende Skript standardmäßig den Ordner .curated ausliest und bei Bedarf mit der Option --path auf den Ordner .experimental umgeschaltet werden kann, um experimentelle Skills einzusehen. Für die Installation einer konkreten Skill aus der kuratierten Liste genügt die Nennung des Namens, woraufhin das Skript install-skill-from-github.py die Skill in das Verzeichnis CODEX_HOME/skills mit dem Namen der Skill anlegt, standardmäßig also unter dem Pfad .codex/skills im Benutzerverzeichnis. Für Skills aus fremden Repositories gibt man stattdessen entweder den Repository-Pfad zusammen mit dem Pfad zur Skill innerhalb des Repositories an oder direkt die vollständige GitHub-URL zum entsprechenden Verzeichnis, optional ergänzt um einen abweichenden Branch-Namen über die Option --ref.

Sicherheit und Best Practices

Da das Installieren einer Skill aus einem beliebigen GitHub-Repository bedeutet, dass Anweisungen und mitunter ausführbare Hilfsskripte von Dritten übernommen werden, sollte man den Inhalt einer SKILL.md-Datei und aller referenzierten Skripte vor der Installation prüfen, besonders wenn die Quelle nicht die von OpenAI kuratierte Liste ist. Die kuratierte Liste unterliegt zumindest einer redaktionellen Auswahl durch OpenAI, während beliebige GitHub-Repositories keiner solchen Prüfung unterliegen und mit derselben Vorsicht behandelt werden sollten wie jede andere externe Code-Abhängigkeit. Der Installer bricht laut Dokumentation ab, wenn das Zielverzeichnis bereits existiert, was ein versehentliches Überschreiben verhindert; die vorinstallierten Systemskills unter .system lassen sich zwar auf ausdrücklichen Wunsch überschreiben, dies wird aber grundsätzlich nicht empfohlen.

Praxisbeispiel und Grenzen

Ein typischer Aufruf besteht darin, den Skill Installer zu bitten, eine bestimmte experimentelle Skill wie eine Planungsskill aus dem Ordner .experimental zu installieren, oder alternativ direkt eine GitHub-Verzeichnis-URL eines Drittanbieter-Repositories anzugeben, aus der eine Skill übernommen werden soll. Die Grenzen liegen darin, dass der Installer selbst keine inhaltliche oder sicherheitstechnische Prüfung der zu installierenden Skill vornimmt, sondern lediglich den Übertragungsvorgang übernimmt, und dass er ausschließlich für die Verzeichnisstruktur von Codex ausgelegt ist. Für Claude Code lässt sich der Skill Installer somit nicht direkt verwenden, da beide Systeme zwar ein ähnliches Grundkonzept verfolgen, aber unterschiedliche Ablageorte und Konfigurationsformate für Skills nutzen.

Veröffentlicht am 09.09.2026

Kategorien

Häufige Fragen

Installiert der Skill beliebige GitHub-Inhalte automatisch?

Nein. Er unterstützt repositorybasierte Pfade, aber Quelle, Revision, Dateien und Berechtigungen müssen vor der Nutzung geprüft werden.

Was passiert bei einer bereits vorhandenen Installation?

Der vorgesehene Ablauf bricht ab, damit eine vorhandene Zielmappe nicht stillschweigend überschrieben wird.