Skill Installer

Offizieller Codex-Skill zum Auflisten und Installieren von Skills aus kuratierten OpenAI-Quellen oder GitHub-Repositories.

Skill Installer ist ein offizieller Beispiel-Skill aus dem OpenAI-Codex-Repository. Die verifizierte Primärquelle ist https://github.com/openai/codex/tree/main/codex-rs/skills/src/assets/samples/skill-installer. Er unterstützt Codex dabei, Skills für lokale Arbeitsumgebungen aufzufinden und in das Skill-Verzeichnis zu installieren. Die von Smithery gemeldete Kandidatenquelle lag zunächst unter codex-rs/core/src/skills/assets/samples/skill-installer. Dieser Pfad ist im aktuellen Hauptzweig nicht mehr erreichbar. Die verifizierte, inhaltlich passende Primärquelle liegt unter codex-rs/skills/src/assets/samples/skill-installer und enthält die SKILL.md sowie die zugehörigen Hilfsskripte. Laut Anbieter ist der Skill für drei typische Situationen vorgesehen: eine Liste verfügbarer Skills anzeigen, einen benannten Skill aus der kuratierten Sammlung installieren oder einen Skill aus einem GitHub-Repository und einem angegebenen Pfad beziehen.

Zweck und Arbeitsweise

Der Skill bündelt einen wiederholbaren Installationsablauf, ohne selbst ein allgemeiner Paketmanager zu sein. Für eine Auflistung verwendet er das Skript list-skills.py. Die Standardsammlung ist der kuratierte Bereich des offiziellen openai/skills-Repositorys; experimentelle Skills können ausdrücklich über den experimentellen Pfad angefordert werden. Für die Installation aus GitHub verweist die Anleitung auf install-skill-from-github.py. Dabei kann ein Repository mit Besitzer und Namen, ein Pfad innerhalb des Repositorys oder eine vollständige GitHub-URL angegeben werden. Die Installation wird standardmäßig direkt heruntergeladen. Wenn Berechtigungs- oder Authentifizierungsprobleme auftreten, kann der vorgesehene Git-Fallback verwendet werden.

Der Zielort ist das Skill-Verzeichnis unter CODEX_HOME/skills, wobei die Umgebung einen eigenen CODEX_HOME-Wert setzen kann. Ohne diese Variable verwendet Codex nach der Anbieterbeschreibung den Standardpfad im Benutzerverzeichnis. Mehrere Pfade können in einem Vorgang installiert werden. Mit einer Namensoption lässt sich der Zielname festlegen; andernfalls wird er aus dem letzten Pfadbestandteil abgeleitet. Der Ablauf bricht ab, wenn das Ziel bereits vorhanden ist, damit eine bestehende Installation nicht stillschweigend überschrieben wird. Nach einer erfolgreichen Installation soll der Nutzer informiert werden, dass der Skill in der nächsten Runde verfügbar ist. Die offizielle Dokumentation weist zusätzlich darauf hin, dass ein Neustart erforderlich sein kann, wenn eine neu installierte Fähigkeit nicht sofort erscheint.

Praktischer Nutzen und Grenzen

Skill Installer ist besonders hilfreich, wenn ein Team die Codex-Fähigkeiten bewusst erweitern möchte, ohne Installationsschritte für jede einzelne Skill-Datei neu zu formulieren. Er macht die Herkunft und den Zielpfad einer Installation nachvollziehbarer und trennt kuratierte, experimentelle und repositorybasierte Quellen. Die eigentliche Qualität des installierten Skills wird dadurch nicht garantiert. Ein erreichbares GitHub-Repository beweist weder die Sicherheit seiner Skripte noch die Vertrauenswürdigkeit aller enthaltenen Anweisungen. Vor einer teamweiten Verwendung sollten Repository, Revision, Lizenz, Änderungsverlauf und benötigte Werkzeuge geprüft werden.

Der Skill ist kein OpenAI-API-Client, kein MCP-Server und keine zentrale Verwaltung für Berechtigungen. Er installiert Dateien in einer lokalen Codex-Umgebung. Netzwerkzugriffe entstehen durch die vorgesehenen Auflistungs- und Downloadvorgänge; bei privaten Repositorys können vorhandene Git-Anmeldedaten oder eine bereits eingerichtete Authentifizierung relevant sein. Zugangsdaten, Tokens, private Quelltexte und vertrauliche Projektdaten gehören nicht in die Skill-Beschreibung oder in Installationsbeispiele. Das installierte Material kann Anweisungen und Skripte enthalten, die später im Kontext eines Agenten verwendet werden. Deshalb sollten Teams eine kontrollierte Arbeitskopie, minimale Berechtigungen und einen menschlichen Review vor produktiven Änderungen verlangen.

Einordnung und Sicherheit

Die offizielle Codex-Dokumentation beschreibt Skills als Verzeichnisse mit einer erforderlichen SKILL.md und optionalen Skripten, Referenzen oder Ressourcen. Skill Installer folgt diesem Modell, indem es komplette Skill-Verzeichnisse statt einzelner Textfragmente installiert. Laut Anbieter sind systemeigene Skills bereits vorinstalliert und müssen normalerweise nicht erneut installiert werden. Wer dennoch eine systemeigene Fähigkeit überschreiben möchte, sollte die Folgen und die lokale Konfiguration ausdrücklich prüfen. Deaktivieren lässt sich eine lokale Fähigkeit über den entsprechenden Skills-Eintrag in der Codex-Konfiguration, ohne die Dateien sofort zu löschen.

Die kanonische Quelle dieses Katalogeintrags ist der aktuelle Codex-Pfad unter codex-rs/skills/src/assets/samples/skill-installer; die ursprüngliche Kandidaten-URL wird als veraltete Registry-Zuordnung dokumentiert. Das Codex-Repository veröffentlicht den Quellstand unter Apache-2.0. GitHub-Sterne werden nicht gespeichert, weil das Skill-Modell kein github_stars-Feld besitzt. Diese Einordnung wurde am 9. September 2026 geprüft. Skill Installer erleichtert die lokale Verteilung, ersetzt aber keine Abhängigkeitsprüfung, keine Rechteprüfung und keine Freigabe durch die zuständige Person.

Installationsanleitung

Schritt 1: 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.

Schritt 2: 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.

Schritt 3: 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.

Kostenlos
Anbieter
OpenAI
Lizenz
Apache-2.0
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien

Kompatibel mit

Codex