Skills en Codex: añade y usa Agent Skills en OpenAI Codex

La respuesta corta

1Pon la carpeta de la Skill en ~/.agents/skills/ para usarla en todos los repositorios, o en la carpeta .agents/skills/ de un repositorio para limitarla a él.
2Codex necesita tanto name (hasta 64 caracteres) como description (hasta 1.024) en SKILL.md.
3Escribe $ más el nombre de la Skill para ejecutarla, o /skills para elegirla de una lista.
4¿Quieres Skills listas para usar? Explora las Skills para Codex que se instalan con un solo comando.

Empieza aquí:Instalar Dónde busca Skills vs AGENTS.md

Antes de empezar

Las Skills funcionan en tres sitios: la CLI de Codex, la extensión de Codex para IDE y Codex en la app de escritorio de ChatGPT. Para instalar desde Skillry con la CLI, también necesitas macOS o Windows y Node.js 22 o superior.

Cómo añadir Skills a Codex

Codex y la CLI de Skillry usan la misma carpeta predeterminada, ~/.agents/skills/, así que no necesitas ninguna opción extra. Elige la vía que más te convenga.

Lo más fácil si ya tienes Codex abierto

1
Abre la Skill en Skillry, selecciona Copiar prompt de instalación y luego Copiar en el cuadro de diálogo.
2
Pégalo en Codex y envíalo. El agente lee las instrucciones de instalación de Skillry y ejecuta él mismo el comando correcto.
Prompt de instalación
```
Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
```
3
Cuando el navegador te pida aprobar un código de dispositivo, apruébalo.
Deberías ver: Codex indica la versión que instaló y la carpeta que usó, dentro de ~/.agents/skills/.

Lo mejor si prefieres ejecutar los comandos tú mismo

1
Inicia sesión una vez. Se abre una ventana del navegador con un código de dispositivo que debes aprobar.
Terminal
```
npx --yes skillry-cli@latest login
```
2
Instala. No necesitas ninguna opción, porque la carpeta predeterminada de la CLI es la que lee Codex.
Terminal
```
npx --yes skillry-cli@latest install <slug>
```
Deberías ver: Installed <slug> <version> to ~/.agents/skills/<slug>

Lo mejor en Linux o si quieres leer los archivos antes

Selecciona Descargar ZIP en la página de la Skill o usa una carpeta de Skill que hayas conseguido en otro sitio. Lee SKILL.md y todo lo que haya en scripts/ antes de instalarla, porque el agente sigue esas instrucciones y puede ejecutar esos scripts. Después mueve la carpeta entera:

Terminal

mkdir -p ~/.agents/skills
mv ~/Downloads/my-skill ~/.agents/skills/

Los ZIP suelen descomprimirse con un nivel extra, como my-skill/my-skill/SKILL.md. SKILL.md tiene que estar directamente dentro de la carpeta de la Skill; si no, el agente no la encontrará.

Codex también tiene su propio instalador para el catálogo de OpenAI, $skill-installer. Coloca las Skills en ~/.codex/skills/, una carpeta antigua que Codex sigue leyendo, así que las Skills de ambos instaladores aparecen juntas.

Comprueba que Codex la encontró

En la CLI o en la extensión para IDE, escribe /skills, o escribe $ y empieza a teclear el nombre. En la app de escritorio de ChatGPT, abre Skills en la barra lateral. Codex detecta las Skills nuevas por su cuenta; si alguna no aparece, reinicia Codex.

Cómo ejecutar una Skill en Codex

Escribe $, el nombre de la Skill y luego tu petición:

CLI de Codex

$launch-page Parcelo, un panel de seguimiento de paquetes para pequeñas tiendas online

Cuando sepas que funciona, puedes pedirlo con tus palabras y Codex elige la Skill cuya descripción encaja. Con muchas Skills instaladas, Codex acorta las descripciones para que la lista completa quepa en un 2 % aproximado de la ventana de contexto. Pon el uso principal en la primera frase de la descripción para que sobreviva al recorte.

Dónde busca Codex las Skills

Codex reúne Skills de cinco ámbitos. En el día a día usarás dos: tu carpeta personal y la del repositorio.

Ámbito	Ubicación
Repositorio	`.agents/skills/` en cada carpeta desde donde inicias Codex hasta la raíz del repositorio
Personal	`~/.agents/skills/`
Personal, antigua	`~/.codex/skills/`, todavía se lee (no aparece en la documentación, pero está confirmado en el código fuente de Codex)
Administrador	`/etc/codex/skills/`
Sistema	Incluidas con Codex, como `$skill-creator` y plan

Codex no fusiona dos Skills con el mismo nombre. Pueden aparecer las dos en el selector, así que elimina o renombra la copia que no quieras.

Skills de Codex vs AGENTS.md

Codex lee AGENTS.md al principio de cada ejecución, así que sirve para reglas breves que siempre se aplican. Una Skill solo se carga cuando una tarea la requiere, así que sirve para procedimientos más largos que repites.

Skill

Se carga cuando hace falta

Una carpeta en .agents/skills/
Se carga cuando una tarea coincide o cuando escribes $name
Ideal para trabajo repetible de varios pasos

AGENTS.md

Se lee al principio de cada ejecución

Primero ~/.codex/AGENTS.md y luego un archivo por carpeta, desde la raíz del repositorio hasta donde empiezas
Los archivos más cercanos a ti sustituyen a los anteriores; 32 KiB en total por defecto
Ideal para reglas breves: comandos de test, estilo de código, límites

Un reparto que funciona bien: deja AGENTS.md en más o menos una pantalla de reglas y pasa todo lo que sea paso a paso a Skills. Skills vs instrucciones lo explica a fondo.

¿Tu Skill de Codex no aparece? Busca tu síntoma

Una Skill que falta suele estar en la carpeta equivocada o descomprimida un nivel más abajo de la cuenta. Busca en la columna de la izquierda lo que estás viendo.

Lo que ves	Solución
No aparece en `/skills`	Muévela a `~/.agents/skills/<name>/` y comprueba que el ZIP no haya añadido un nivel extra
Aparece sin descripción	Corrige el frontmatter. Codex necesita tanto `name` como `description`
Falta una Skill de proyecto	Inicia Codex desde dentro del repositorio
`$` no encuentra nada en la app de escritorio de ChatGPT	Es un error conocido (openai/codex#28505). Revisa `/skills`, reinicia o prueba con una copia en `~/.codex/skills/` (aún no lo hemos probado)

Preguntas frecuentes

¿Dónde se guardan las Skills de Codex?

~/.agents/skills/ para tus propias Skills, .agents/skills/ dentro de un repositorio y /etc/codex/skills/ para administradores. Codex también lee la antigua ~/.codex/skills/, que es donde $skill-installer coloca las Skills.

¿Qué diferencia hay entre las Skills de Codex y AGENTS.md?

AGENTS.md se lee al principio de cada ejecución. Una Skill solo se carga cuando una tarea la necesita.

¿Funcionan las Skills de Codex en ChatGPT?

Las Skills independientes funcionan en la app de escritorio de ChatGPT, la CLI de Codex y la extensión para IDE. Para usar una en ChatGPT en la web o en el móvil, distribúyela dentro de un plugin.