OpenAI Skills
Instalar una skill de OpenAI fijada: destinos, alternativas y lotes parciales
Analiza el instalador obsoleto antes de usarlo: revisión y destino explícitos, archivo completo o Git disperso, rechazo de carpetas existentes y copias no atómicas.
Qué aprenderás
- Instalar modifica archivos, no despliega un servicio
- Identifica qué ruta de recuperación puede ejecutarse
- Prepara la recuperación antes de copiar un lote
Antes de empezar
- Conceptos básicos de Git, Python y terminal
- Límites explícitos para inspeccionar y modificar repositorios
Explica el comportamiento del capítulo y aplica su lista sin confundir catálogo y anfitrión.
Conclusiones clave
- Especifica revisión, ruta y destino de revisión.
- La alternativa automática cubre ciertos errores HTTP, no cualquier fallo.
- La instalación de varias skills no es atómica.
Instalar modifica archivos, no despliega un servicio
El instalador examinado copia una carpeta seleccionada a un destino. Su valor predeterminado deriva de CODEX_HOME o del directorio .codex del usuario; --dest permite elegir otro lugar. El ejemplo utiliza deliberadamente una carpeta de revisión. Copiar allí prepara material para inspección, pero no demuestra que el anfitrión actual vaya a descubrirlo o activarlo.
Fija la revisión completa y proporciona la ruta del repositorio por separado. El analizador de URL interpreta un único segmento después de tree o blob como ref, por lo que una rama con barra resulta ambigua en ese formato. Los argumentos --repo, --ref y --path evitan esa división concreta. El comando es una referencia, no una instalación realizada en esta revisión.
Identifica qué ruta de recuperación puede ejecutarse
El modo de descarga lee un archivo completo de codeload en memoria y después lo escribe y extrae en un área temporal. El modo auto lo intenta primero, pero su alternativa se activa ante errores del instalador que contienen HTTP 401, 403 o 404. Un timeout arbitrario o un archivo inválido no es una señal general de reintento en esa rama.
La ruta Git solicita clonación superficial, filtrada y dispersa, e intenta HTTPS antes de SSH en su camino de error controlado. Ambos transportes dependen de las credenciales y confianza existentes en la máquina. Diagnostica la rama que realmente falló; no desactives certificados ni comprobaciones de clave de host para que un ejemplo parezca funcionar.
Prepara la recuperación antes de copiar un lote
Para cada ruta, el instalador valida el nombre de destino, rechaza una carpeta existente, comprueba que el origen contiene SKILL.md y copia el directorio. Esto no constituye una auditoría completa del esquema, scripts o dependencias. Además, --name solo se aplica cuando hay una ruta seleccionada; no renombra todas las entradas de un lote.
El bucle copia las entradas individualmente. Si una posterior colisiona o resulta inválida, ninguna transacción revierte las copias anteriores. Limpiar el repositorio temporal es distinto de deshacer las carpetas instaladas. Tras un error, inventaría los destinos reales, conserva el contenido previo y promueve una carpeta revisada mediante un proceso explícito, no borrando hasta que desaparezca el mensaje.
Pasos de implementación
- 1
Registra la revisión y comprueba la licencia seleccionada.
- 2
Inspecciona archivo y ayudantes en un destino aislado.
- 3
Resuelve colisiones sin sobrescribir skills existentes.
- 4
Verifica descubrimiento y comportamiento antes de activar.
Ejemplo para copiar
python /path/to/reviewed/install-skill-from-github.py --repo openai/skills --ref 49f948faa9258a0c61caceaf225e179651397431 --path skills/.curated/gh-fix-ci --dest ./skill-review --method downloadPreguntas frecuentes
¿El ejemplo escribe en el directorio activo de Codex?
Utiliza ./skill-review en lugar del destino predeterminado. Prepara archivos para revisión; la activación requiere otra comprobación.
¿Un lote fallido puede dejar algunas skills copiadas?
Sí. El bucle realiza copias individuales y no revierte las anteriores cuando falla una entrada posterior.
Fuentes
- README.mdFuente verificada 2026-09-08
- skills/.system/skill-installer/SKILL.mdFuente verificada 2026-09-08
- skills/.system/skill-installer/LICENSE.txtFuente verificada 2026-09-08
- skills/.system/skill-installer/scripts/install-skill-from-github.pyFuente verificada 2026-09-08
- skills/.system/skill-installer/scripts/github_utils.pyFuente verificada 2026-09-08
- skills/.system/skill-installer/scripts/list-skills.pyFuente verificada 2026-09-08
- skills/.system/skill-creator/scripts/quick_validate.pyFuente verificada 2026-09-08
- skills/.system/skill-creator/references/openai_yaml.mdFuente verificada 2026-09-08
- skills/.curated/gh-fix-ci/SKILL.mdFuente verificada 2026-09-08
- skills/.curated/gh-fix-ci/scripts/inspect_pr_checks.pyFuente verificada 2026-09-08
- skills/.curated/gh-fix-ci/agents/openai.yamlFuente verificada 2026-09-08
- skills/.system/plugin-creator/SKILL.mdFuente verificada 2026-09-08
- Guía oficial actual de skillsFuente verificada 2026-09-08