grahama1970/skill-installer

Instalador de Habilidades

Ayuda a instalar habilidades. Por defecto provienen de https://github.com/openai/skills/tree/main/skills/.curated, pero los usuarios también pueden proporcionar otras ubicaciones. Las habilidades experimentales están 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:

• Listar habilidades cuando el usuario pregunte qué está disponible, o si el usuario usa esta habilidad sin especificar qué hacer. La lista por defecto es .curated, pero puedes pasar --path skills/.experimental cuando pregunten sobre habilidades experimentales.
• Instalar desde la lista curada cuando el usuario proporcione un nombre de habilidad.
• Instalar desde otro repositorio cuando el usuario proporcione una ruta de repositorio de GitHub (incluyendo repositorios privados).

Instala habilidades con los scripts auxiliares.

Comunicación

Al listar habilidades, la salida debe ser aproximadamente como se muestra a continuación, dependiendo del contexto de la solicitud del usuario. Si preguntan sobre habilidades experimentales, lista desde .experimental en lugar de .curated e indica la fuente correspondientemente: """ Habilidades de {repo}:

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

Después de instalar una habilidad, informa al usuario que estará disponible en su siguiente turno.

Scripts

Todos estos scripts usan red, por lo que al ejecutarlos en la caja de arena, solicita escalamiento cuando los ejecutes.

• scripts/list-skills.py (imprime la lista de habilidades con anotaciones de instalación)
• scripts/list-skills.py --format json
• Ejemplo (lista experimental): 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>
• Ejemplo (habilidad experimental): scripts/install-skill-from-github.py --repo openai/skills --path skills/.experimental/<nombre-de-habilidad>

Comportamiento y Opciones

• Por defecto usa descarga directa para repositorios públicos de GitHub.
• Si la descarga falla con errores de autenticación/permisos, recurre a git sparse checkout.
• Se aborta si el directorio de destino de la habilidad ya existe.
• Instala en $CODEX_HOME/skills/<nombre-de-habilidad> (por defecto ~/.codex/skills).
• Múltiples valores --path instalan varias habilidades en una ejecución, cada una nombrada según el nombre base de la ruta a menos que se proporcione --name.
• Opciones: --ref <ref> (por defecto main), --dest <ruta>, --method auto|download|git.

Notas

• La lista curada se obtiene de https://github.com/openai/skills/tree/main/skills/.curated a través de la API de GitHub. Si no está disponible, explica el error y sal.
• Los repositorios privados de GitHub se pueden acceder mediante credenciales git existentes o el token opcional GITHUB_TOKEN/GH_TOKEN para la descarga.
• El fallback de git intenta HTTPS primero, luego SSH.
• Las habilidades en https://github.com/openai/skills/tree/main/skills/.system están preinstaladas, por lo que no es necesario ayudar a los usuarios a instalarlas. Si preguntan, simplemente explícalo. Si insisten, puedes descargar y sobrescribir.
• Las anotaciones de instalación provienen de $CODEX_HOME/skills.