skill-installer

Installateur de compétences

Permet d'installer des compétences. Par défaut, celles-ci proviennent de https://github.com/openai/skills/tree/main/skills/.curated, mais les utilisateurs peuvent également indiquer d'autres emplacements. Les compétences expérimentales se trouvent sur https://github.com/openai/skills/tree/main/skills/.experimental et peuvent être installées de la même manière.

Utilisez les scripts d'aide en fonction de la tâche :

• Affichez la liste des compétences lorsque l'utilisateur demande ce qui est disponible, ou s'il utilise cette compétence sans préciser ce qu'il souhaite faire. La liste par défaut est .curated, mais vous pouvez passer l'option --path skills/.experimental lorsqu'il demande des compétences expérimentales.
• Effectuez l’installation à partir de la liste « curated » lorsque l’utilisateur fournit le nom d’une compétence.
• Effectuez l’installation à partir d’un autre dépôt lorsque l’utilisateur fournit un dépôt GitHub ou un chemin d’accès (y compris les dépôts privés).

Installez les compétences à l’aide des scripts d’aide.

Communication

Lors de l'affichage de la liste des compétences, affichez un résultat similaire à celui-ci, en fonction du contexte de la demande de l'utilisateur. S'il demande des compétences expérimentales, affichez la liste à partir de .experimental au lieu de .curated et indiquez la source en conséquence : """ Compétences issues de {repo} :

1. skill-1
2. skill-2 (déjà installée)
3. ... Lesquelles souhaitez-vous installer ? """

Après l'installation d'une compétence, indiquez à l'utilisateur qu'elle sera disponible à son prochain tour.

Scripts

Tous ces scripts utilisent le réseau ; par conséquent, lorsque vous les exécutez dans le bac à sable, demandez une élévation de privilèges avant de les lancer.

• scripts/list-skills.py (affiche la liste des compétences 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 / --path <chemin/vers/skill> [<chemin/vers/skill> ...]
• scripts/install-skill-from-github.py --url https://github.com///tree//
• Exemple (compétence expérimentale) : scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/

Comportement et options

• Par défaut, téléchargement direct pour les dépôts GitHub publics.
• Si le téléchargement échoue en raison d’erreurs d’authentification ou d’autorisation, le système revient au « git sparse checkout ».
• Le processus est interrompu si le répertoire de destination de la compétence existe déjà.
• L'installation s'effectue dans $CODEX_HOME/skills/ (par défaut : ~/.codex/skills).
• Plusieurs valeurs --path permettent d’installer plusieurs compétences en une seule exécution, chacune étant nommée d’après le nom de base du chemin d’accès, sauf si l’option --name est fournie.
• Options : --ref (par défaut : main), --dest , --method auto|download|git.

Remarques

• La liste sélectionnée 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, l’erreur est expliquée et le programme se termine.
• Les dépôts GitHub privés sont accessibles via les identifiants Git existants ou, en option, viaGITHUB_TOKEN/GH_TOKEN pour le téléchargement.
• Le protocole de secours Git tente d’abord HTTPS, puis SSH.
• Les compétences disponibles sur https://github.com/openai/skills/tree/main/skills/.system sont préinstallées ; il n’est donc pas nécessaire d’aider les utilisateurs à les installer. S’ils vous le demandent, expliquez-leur simplement cela. S’ils insistent, vous pouvez les télécharger et les remplacer.
• Les annotations installées proviennent de $CODEX_HOME/skills.