Zum Inhalt springen

potato-skill in Codex einrichten

Fügen Sie potato-skill mit einem npx-Befehl zu einem Codex-Projekt hinzu, starten Sie den Skill mit $potato-skill und geben Sie die Befehle frei, die die Standard-Sandbox zurückhält.

Codex liest Skills aus .agents/skills/ in Ihrem Repository, und npx skills add davidjurgens/potato-skill --agent codex kopiert potato-skill dorthin. Codex erkennt den Skill ohne Neustart, und $potato-skill startet den Skill in der CLI und in der IDE-Erweiterung. Schnellstart mit einem Coding-Agenten erklärt, was der Skill mit einer Studie macht, und potato-skill in Ihrem Coding-Agenten installieren behandelt die anderen Agenten.

Vor der Installation

Potato gehört in die Python-Umgebung, die die Shell von Codex verwendet. Die Hilfsskripte des Skills importieren die Registries von Potato und rufen den Befehl potato auf, und der erste Schritt des Skills prüft, ob sich Potato importieren lässt. Das Browser-Extra und Chromium erlauben es potato preview --screenshot und dem Walkthrough-Skript des Skills, die Aufgabe in einem Headless-Browser zu öffnen.

bash
pip install 'potato-annotation[preview]'
playwright install chromium

Die Standard-Sandbox von Codex hat keinen Netzwerkzugriff. Installieren Sie beides vor dem Start, um sich eine Runde Freigaben zu sparen. Die skills-CLI läuft über npx und benötigt Node.js 22.20 oder neuer.

Den Skill installieren

Führen Sie die Installation in Ihrem Repository aus.

bash
npx skills add davidjurgens/potato-skill --agent codex

Der Befehl kopiert SKILL.md, die 30 Referenzdateien und die neun Hilfsskripte nach .agents/skills/potato-skill/ und trägt die Quelle in skills-lock.json im Repository-Stammverzeichnis ein. Codex durchsucht .agents/skills/ in jedem Ordner vom aktuellen bis zum Repository-Stammverzeichnis, sodass auch eine Sitzung, die in einem Unterordner des Repositorys beginnt, den Skill findet. Das Einchecken von .agents/skills/ gibt Mitarbeitenden den Skill ohne Installationsschritt.

Fügen Sie -g hinzu, um den Skill stattdessen für jedes Repository auf dem Rechner zu installieren.

bash
npx skills add davidjurgens/potato-skill --agent codex -g

Eine globale Installation landet in ~/.agents/skills/potato-skill/, dem Skill-Ordner auf Benutzerebene, den Codex liest. Codex erkennt einen neuen Skill ohne Neustart. Wenn der Skill nicht erscheint, starten Sie Codex neu.

Die Installation prüfen

In der Codex CLI oder der IDE-Erweiterung listet /skills die Skills auf, die Codex gefunden hat, und potato-skill steht in der Liste. In der ChatGPT-Desktop-App zeigt Skills in der Seitenleiste die Skills Ihrer Projekte.

Eine Studie starten

Nennen Sie den Skill mit $potato-skill und beschreiben Sie die Studie.

text
$potato-skill I want 200 tweets labeled for sentiment on a 5-point scale by three annotators each, with a consent page and two attention checks. Build it and start it.

Codex lädt den Skill auch ohne Erwähnung, wenn eine Anfrage zur Beschreibung des Skills passt, etwa die Bitte, eine Annotationsaufgabe aufzubauen, eine Potato-config.yaml zu bearbeiten oder eine laufende Studie zu prüfen.

Sandbox und Freigaben

Codex führt Befehle in einer Sandbox aus. Der Standardmodus workspace-write erlaubt Befehlen, innerhalb des Arbeitsbereichs zu schreiben, bei abgeschaltetem Netzwerkzugriff. Die Einstellung hinter dem Netzwerk ist sandbox_workspace_write.network_access, die standardmäßig false ist. Unter der Freigaberichtlinie on-request arbeitet Codex innerhalb der Sandbox und fragt nach, bevor ein Befehl über die Sandbox hinausgeht.

Während eines Aufbaus lässt der Skill Codex die Konfiguration validieren, einen Potato-Server auf Ihrem Rechner starten, die Aufgabe in einem Headless-Browser öffnen und die Hilfsskripte des Skills ausführen. Ein pip install braucht das Netzwerk, und die Standard-Sandbox hat keines. Geben Sie einen Befehl außerhalb der Sandbox frei, wenn Codex nachfragt, und lesen Sie den Befehl vorher. In der CLI öffnet /permissions die Auswahl der Berechtigungen. In der IDE-Erweiterung und in der App stehen dieselben Optionen unter dem Eingabefeld als Ask for approval, Approve for me und Full access. Die Sandbox-Dokumentation von Codex beschreibt jeden Modus.

AGENTS.md

Codex liest AGENTS.md anhand des Dateinamens. Das Repository von potato-skill hat im Stammverzeichnis eine AGENTS.md, eine kurze Zusammenfassung der Regeln des Skills. Wer diese Datei in das Stammverzeichnis des eigenen Repositorys kopiert, gibt Codex die Regeln ohne Installationsschritt. Die Datei verweist auf Referenzdateien und Skripte, die nur eine vollständige Installation auf die Platte legt. Nutzen Sie für den Aufbau einer Studie die Installation mit der skills-CLI. Wenn Ihr Repository bereits eine AGENTS.md hat, fügen Sie die Zusammenfassung zu dieser Datei hinzu, statt die Datei zu ersetzen.

Den Skill aktualisieren und entfernen

Die skills-CLI aktualisiert und entfernt den Skill über seinen Namen. Fügen Sie bei einer globalen Installation -g zu einem der beiden Befehle hinzu.

bash
npx skills update potato-skill
npx skills remove potato-skill

update vergleicht die installierte Kopie mit dem GitHub-Repository und ersetzt die Kopie, wenn sich das Repository geändert hat. remove löscht .agents/skills/potato-skill/ und den Eintrag des Skills in skills-lock.json.

Um den Skill auszuschalten, ohne ihn zu löschen, fügen Sie ~/.codex/config.toml einen Eintrag mit dem absoluten Pfad der SKILL.md des Skills hinzu und starten Codex neu. Die Skills-Dokumentation von Codex listet die weiteren Einstellungen auf, die ein Eintrag annimmt.

toml
[[skills.config]]
path = "/path/to/your/repo/.agents/skills/potato-skill/SKILL.md"
enabled = false