Installeur de Skills

Aide à installer des skills. Par défaut, ceux-ci proviennent de https://github.com/openai/skills/tree/main/skills/.curated, mais les utilisateurs peuvent également fournir d'autres emplacements.

Utilisez les scripts d'aide selon la tâche :

• Lister les skills quand l'utilisateur demande ce qui est disponible, ou si l'utilisateur utilise ce skill sans spécifier ce qu'il faut faire. La liste par défaut est .curated, mais vous pouvez passer --path skills/.experimental quand ils demandent des skills expérimentaux.
• Installer depuis la liste curated quand l'utilisateur fournit un nom de skill.
• Installer depuis un autre repo quand l'utilisateur fournit un chemin/repo GitHub (y compris les repos privés).

Installez les skills avec les scripts d'aide.

Communication

Lors de la listing des skills, affichez approximativement comme suit, selon le contexte de la demande de l'utilisateur. S'ils demandent des skills expérimentaux, listez depuis .experimental au lieu de .curated et étiquetez la source en conséquence : """ Skills from {repo}:

1. skill-1
2. skill-2 (already installed)
3. ... Which ones would you like installed? """

Après avoir installé un skill, dites à l'utilisateur : "Restart Codex to pick up new skills."

Scripts

Tous ces scripts utilisent le réseau, donc lors de l'exécution dans le sandbox, demandez une escalade en les exécutant.

• scripts/list-skills.py (affiche la liste des skills avec les annotations installées)
• scripts/list-skills.py --format json
• Exemple (liste expérimentale) : 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>
• Exemple (skill expérimental) : scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<skill-name>

Comportement et Options

• Par défaut, téléchargement direct pour les repos GitHub publics.
• En cas d'échec du téléchargement avec des erreurs d'authentification/permission, basculez sur un sparse checkout git.
• Abandonne si le répertoire de destination du skill existe déjà.
• Installe dans $CODEX_HOME/skills/<skill-name> (par défaut ~/.codex/skills).
• Plusieurs valeurs --path installent plusieurs skills en une seule exécution, nommés d'après le basename du chemin sauf si --name est fourni.
• Options : --ref <ref> (défaut main), --dest <path>, --method auto|download|git.

Notes

• La listing curated est récupérée depuis https://github.com/openai/skills/tree/main/skills/.curated via l'API GitHub. Si elle n'est pas disponible, expliquez l'erreur et quittez.
• Les repos GitHub privés peuvent être accessibles via les credentials git existants ou optionnellement GITHUB_TOKEN/GH_TOKEN pour le téléchargement.
• Le fallback git essaie d'abord HTTPS, puis SSH.
• Les skills à https://github.com/openai/skills/tree/main/skills/.system sont préinstallés, donc pas besoin d'aider les utilisateurs à les installer. S'ils le demandent, expliquez simplement ceci. S'ils insistent, vous pouvez télécharger et écraser.
• Les annotations installées proviennent de $CODEX_HOME/skills.