Grundlagen
Codex Skills installieren und Berechtigungen prüfen
Zuletzt überarbeitet · Redaktion Text-Technology
Coding-Agenten lassen sich mit sogenannten Skills um wiederkehrende Arbeitsabläufe erweitern. Auch OpenAI Codex unterstützt dieses Konzept. Ein Skill bündelt Anweisungen, Prüfschritte und gegebenenfalls Hilfsskripte für genau eine Aufgabe. Der Agent lädt ihn, wenn eine passende Aufgabe ansteht. Damit Skills im Alltag helfen und nicht zum Risiko werden, lohnt sich ein genauer Blick auf Aufbau, Installation und Berechtigungen.
Wie ein Codex Skill aufgebaut ist
Ein Skill ist ein Ordner mit einer Datei namens SKILL.md. Am Anfang dieser Datei steht ein kurzer Kopfbereich mit Metadaten. Codex verlangt dort die Felder name und description. Die Beschreibung ist besonders wichtig, denn anhand dieses Textes entscheidet der Agent, wann der Skill zum Einsatz kommt. Darunter folgen die eigentlichen Anweisungen in Markdown. Zusätzliche Dateien wie Skripte oder Vorlagen können im selben Ordner liegen.
Codex sucht Skills im Projektordner unter .agents/skills oder im Home-Verzeichnis des Nutzers. Ein Skill im Projekt gilt nur dort, ein Skill im Home-Verzeichnis steht in allen Projekten zur Verfügung.
Installation in der Praxis
Für die Installation bietet Codex einen eingebauten Installer. Man gibt $skill-installer gefolgt vom Namen eines Skills oder der URL eines GitHub-Ordners ein. Codex lädt den Ordner dann an die passende Stelle. Alternativ lässt sich ein Skill-Ordner auch manuell kopieren.
Eine Übersicht mit kopierfertigen Installationsbefehlen bietet die englischsprachige Codex-Skill-Library von Answer the Web. Dort sind unter anderem Open-Source-Skills von OpenAI aufgeführt, etwa zum Abarbeiten von Review-Kommentaren in GitHub-Pull-Requests, zur Analyse fehlschlagender GitHub-Actions-Prüfungen oder zur Browsersteuerung mit Playwright, zusammen mit einer SKILL.md-Vorlage. Die Seite weist selbst darauf hin, dass eigene Skills des Anbieters bisher in Claude Code und noch nicht in Codex getestet sind.
Berechtigungen prüfen, bevor ein Skill läuft
Ein Skill kann den Agenten anweisen, Befehle auszuführen, Dateien zu ändern oder externe Dienste anzusprechen. Deshalb sollte jeder fremde Skill vor dem Einsatz gelesen werden, so wie man auch ein unbekanntes Skript nicht ungeprüft startet.
- SKILL.md vollständig lesen: Welche Schritte beschreibt der Skill, welche Befehle nennt er?
- Beigelegte Skripte prüfen: Werden Dateien gelöscht, Netzwerkverbindungen aufgebaut oder Zugangsdaten gelesen?
- Externe Abhängigkeiten klären: Benötigt der Skill einen MCP-Server, eine Kommandozeile wie gh oder einen API-Schlüssel?
- Herkunft prüfen: Stammt der Skill aus einem gepflegten Repository, gibt es eine Lizenz, wer pflegt ihn?
- Freigaben des Agenten beachten: Codex arbeitet mit Freigabestufen für Befehle und Dateizugriffe. Ein Skill sollte keine weitreichenderen Rechte erfordern, als für die Aufgabe nötig sind.
Warum Skills manchmal nicht geladen werden
| Problem | Typische Ursache |
|---|---|
| Skill wird nicht erkannt | Ordner liegt am falschen Ort oder SKILL.md fehlt |
| Skill wird nie ausgewählt | Beschreibung zu allgemein oder zu knapp |
| Fehler beim Start | Pflichtfelder name oder description fehlen |
| Befehle schlagen fehl | Benötigte Werkzeuge sind nicht installiert |
Skills zwischen Codex und Claude Code teilen
Das SKILL.md-Format ist weitgehend kompatibel mit dem von Anthropic für Claude Code. Claude Code liest Skills aus .claude/skills beziehungsweise ~/.claude/skills. Wer beide Werkzeuge nutzt, beschränkt sich im Kopfbereich am besten auf die Felder des offenen Standards, also name, description, license, compatibility, metadata und allowed-tools, und legt denselben Ordner an beiden Orten ab.
Eigene Skills schreiben
Wer selbst einen Skill anlegen will, beginnt am besten mit einer Aufgabe, die im Team häufig vorkommt, etwa dem Vorbereiten eines Releases oder dem Prüfen von Abhängigkeiten. Die Beschreibung im Kopfbereich sollte konkret sagen, wann der Skill gebraucht wird. Im Hauptteil helfen nummerierte Schritte, klare Abbruchbedingungen und ein Abschnitt mit bekannten Fehlern. Skripte, die der Skill nutzt, gehören in denselben Ordner und sollten ohne versteckte Netzwerkzugriffe auskommen. Ein eigener Skill sollte wie Code behandelt werden: im Repository versioniert, per Review geprüft und bei Änderungen am Projekt angepasst.
Fazit
Skills machen Coding-Agenten verlässlicher, weil sie bewährte Abläufe festhalten. Die Installation ist schnell erledigt, die Prüfung sollte es nicht sein. Wer jeden fremden Skill vor dem Einsatz liest, Abhängigkeiten klärt und die Freigaben des Agenten bewusst setzt, nutzt die Vorteile ohne unnötige Risiken.
Lesen Sie auch
- Virtual, Augmented und Mixed Reality einfach erklärt
- NFC-Visitenkarten erklärt: Technik, Grenzen und Einsatz im Alltag
- Makleralleinauftrag: Vor- und Nachteile für Verkäufer
- Halteverbot beantragen: Rechtsgrundlagen, Zuständigkeit und Ablauf in Berlin
- KI-Praxisworkshop fürs kleine Team: Was er leisten sollte