skill-installer

Instalador de habilidades

Ayuda a instalar habilidades. Por defecto, estas proceden de https://github.com/openai/skills/tree/main/skills/.curated, pero los usuarios también pueden indicar otras ubicaciones. Las habilidades experimentales se encuentran en https://github.com/openai/skills/tree/main/skills/.experimental y se pueden instalar de la misma manera.

Utiliza los scripts auxiliares según la tarea:

• Muestra una lista de habilidades cuando el usuario pregunte qué hay disponible o si utiliza esta habilidad sin especificar qué hacer. La lista predeterminada es .curated, pero puedes pasar --path skills/.experimental cuando pregunten por habilidades experimentales.
• Instala desde la lista «curated» cuando el usuario indique el nombre de una habilidad.
• Instálalas desde otro repositorio cuando el usuario proporcione un repositorio o una ruta de GitHub (incluidos los repositorios privados).

Instala habilidades con los scripts de ayuda.

Comunicación

Al mostrar la lista de habilidades, muestra un resultado similar al siguiente, dependiendo del contexto de la solicitud del usuario. Si pregunta por habilidades experimentales, muestra la lista de .experimental en lugar de .curated e indica la fuente en consecuencia: """ Habilidades de {repo}:

1. skill-1
2. skill-2 (ya instalada)
3. ... ¿Cuáles te gustaría instalar? """

Tras instalar una habilidad, indica al usuario que estará disponible en su siguiente turno.

Scripts

Todos estos scripts utilizan la red, por lo que, al ejecutarlos en el entorno de pruebas, solicita una escalación.

• scripts/list-skills.py (muestra la lista de habilidades con las anotaciones instaladas)
• scripts/list-skills.py --format json
• Ejemplo (lista experimental): scripts/list-skills.py --path skills/.experimental
• scripts/install-skill-from-github.py --repo / --path <ruta/a/la/habilidad> [<ruta/a/la/habilidad> ...]
• scripts/install-skill-from-github.py --url https://github.com///tree//
• Ejemplo (habilidad experimental): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/

Comportamiento y opciones

• Por defecto, se realiza una descarga directa de los repositorios públicos de GitHub.
• Si la descarga falla por errores de autenticación o permisos, se recurre a la descarga parcial de Git.
• Se interrumpe si el directorio de destino de la habilidad ya existe.
• Se instala en $CODEX_HOME/skills/ (por defecto, en ~/.codex/skills).
• Varios valores de --path permiten instalar varias habilidades en una sola ejecución; a cada una se le asignará un nombre basado en el nombre base de la ruta, a menos que se especifique --name.
• Opciones: --ref (por defecto «main»), --dest , --method auto|download|git.

Notas

• La lista seleccionada se obtiene de https://github.com/openai/skills/tree/main/skills/.curated a través de la API de GitHub. Si no está disponible, se explica el error y se sale del programa.
• Se puede acceder a los repositorios privados de GitHub mediante las credenciales de Git existentes o, de forma opcional, medianteGITHUB_TOKEN/GH_TOKEN para la descarga.
• El protocolo alternativo de Git intenta primero HTTPS y, a continuación, SSH.
• Las habilidades de https://github.com/openai/skills/tree/main/skills/.system vienen preinstaladas, por lo que no es necesario ayudar a los usuarios a instalarlas. Si te lo preguntan, simplemente explícaselo. Si insisten, puedes descargarlas y sobrescribirlas.
• Las anotaciones instaladas proceden de $CODEX_HOME/skills.