Skill-Installer

Was macht Skill-Installer?

Hilft beim Installieren von Skills. Standardmäßig stammen diese aus https://github.com/openai/skills/tree/main/skills/.curated, Benutzer können aber auch andere Quellen angeben. Experimentelle Skills befinden sich unter https://github.com/openai/skills/tree/main/skills/.experimental und können auf die gleiche Weise installiert werden.

Verwende die Hilfsskripte basierend auf der Aufgabe:

• Liste Skills auf, wenn der Benutzer fragt, was verfügbar ist, oder wenn der Benutzer diesen Skill ohne Angabe einer Aktion verwendet. Die Standardliste ist .curated, aber du kannst --path skills/.experimental übergeben, wenn der Benutzer nach experimentellen Skills fragt.
• Installiere aus der kuratierten Liste, wenn der Benutzer einen Skill-Namen angibt.
• Installiere aus einem anderen Repo, wenn der Benutzer einen GitHub-Repo/Pfad angibt (inklusive privater Repos).

Installiere Skills mit den Hilfsskripten.

Kommunikation

Wenn du Skills auflistest, gib sie etwa wie folgt aus, abhängig vom Kontext der Benutzeranfrage. Wenn der Benutzer nach experimentellen Skills fragt, liste aus .experimental statt .curated und kennzeichne die Quelle entsprechend: """ Skills aus {repo}:

1. skill-1
2. skill-2 (bereits installiert)
3. ... Welche möchtest du installieren? """

Nach der Installation eines Skills teile dem Benutzer mit, dass der Skill bei seiner nächsten Runde verfügbar sein wird.

Skripte

Alle diese Skripte verwenden Netzwerkzugriff. Wenn sie in der Sandbox ausgeführt werden, bitte um Eskalation während der Ausführung.

• scripts/list-skills.py (gibt die Skills-Liste mit Installationshinweisen aus)
• scripts/list-skills.py --format json
• Beispiel (experimentelle Liste): scripts/list-skills.py --path skills/.experimental
• scripts/install-skill-from-github.py --repo <owner>/<repo> --path <path/to/skill> [<path/to/skill> ...]
• scripts/install-skill-from-github.py --url https://github.com/<owner>/<repo>/tree/<ref>/<path>
• Beispiel (experimenteller Skill): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>

Verhalten und Optionen

• Standardmäßig wird ein direkter Download für öffentliche GitHub-Repos verwendet.
• Wenn der Download mit Authentifizierungs-/Berechtigungsfehlern fehlschlägt, wird auf Git-Sparse-Checkout zurückgegriffen.
• Der Vorgang wird abgebrochen, wenn das Zielverzeichnis des Skills bereits existiert.
• Installiert in $CODEX_HOME/skills/<skill-name> (Standard: ~/.codex/skills).
• Mehrere --path-Werte installieren mehrere Skills in einem Durchlauf, wobei jeder nach dem Basisnamen des Pfades benannt wird, es sei denn, --name wird angegeben.
• Optionen: --ref <ref> (Standard main), --dest <path>, --method auto|download|git.

Hinweise

• Die kuratierte Liste wird über die GitHub-API von https://github.com/openai/skills/tree/main/skills/.curated abgerufen. Falls sie nicht verfügbar ist, erkläre den Fehler und beende das Programm.
• Auf private GitHub-Repos kann über vorhandene Git-Anmeldeinformationen oder optional GITHUB_TOKEN/GH_TOKEN für den Download zugegriffen werden.
• Der Git-Fallback versucht zuerst HTTPS, dann SSH.
• Die Skills unter https://github.com/openai/skills/tree/main/skills/.system sind vorinstalliert, daher ist es nicht nötig, Benutzern bei deren Installation zu helfen. Falls sie danach fragen, erkläre es einfach. Falls sie darauf bestehen, kannst du herunterladen und überschreiben.
• Installationshinweise stammen aus $CODEX_HOME/skills.