skill-installer

Installez les compétences Codex dans $CODEX_HOME/skills à partir d'une liste organisée ou d'un chemin de dépôt GitHub. À utiliser lorsqu'un utilisateur demande de lister les compétences installables, d'installer une compétence organisée ou d'installer une compétence à partir d'un autre dépôt (y compris les dépôts privés).

npx skills add https://github.com/openai/skills --skill skill-installer

Installateur de compétences

Aide à 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 fournir d'autres emplacements.

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

  • Lister les compétences quand l'utilisateur demande ce qui est disponible, ou si l'utilisateur utilise cette compétence 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 compétences expérimentales.
  • Installer à partir de la liste organisée quand l'utilisateur fournit un nom de compétence.
  • Installer à partir d'un autre dépôt quand l'utilisateur fournit un chemin/dépôt GitHub (y compris les dépôts privés).

Installez les compétences avec les scripts d'assistance.

Communication

Lors de la liste des compétences, affichez approximativement comme suit, selon le contexte de la demande de l'utilisateur. S'ils demandent des compétences expérimentales, listez à partir de .experimental au lieu de .curated et étiquez la source en conséquence : """ Compétences 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, dites à l'utilisateur : « Redémarrez Codex pour activer les nouvelles compétences. »

Scripts

Tous ces scripts utilisent le réseau, donc lors de l'exécution dans le bac à sable, demandez une escalade lors de leur exécution.

  • scripts/list-skills.py (affiche la liste des compétences avec 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 (compétence expérimentale) : 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 dépôts GitHub publics.
  • En cas d'échec du téléchargement avec des erreurs d'authentification/permission, revient à git sparse checkout.
  • Abandonne si le répertoire de compétences de destination existe déjà.
  • Installe dans $CODEX_HOME/skills/<skill-name> (par défaut ~/.codex/skills).
  • Plusieurs valeurs --path installent plusieurs compétences en une seule exécution, chacune nommée d'après le basename du chemin sauf si --name est fourni.
  • Options : --ref <ref> (par défaut main), --dest <path>, --method auto|download|git.

Remarques

  • La liste organisée est récupérée de https://github.com/openai/skills/tree/main/skills/.curated via l'API GitHub. Si elle est indisponible, expliquez l'erreur et quittez.
  • Les dépôts GitHub privés sont accessibles via les identifiants git existants ou optionnels GITHUB_TOKEN/GH_TOKEN pour le téléchargement.
  • Le retour Git essaie d'abord HTTPS, puis SSH.
  • Les compétences à https://github.com/openai/skills/tree/main/skills/.system sont préinstallées, donc pas besoin d'aider les utilisateurs à les installer. S'ils demandent, expliquez simplement cela. S'ils insistent, vous pouvez télécharger et remplacer.
  • Les annotations installées proviennent de $CODEX_HOME/skills.