Saltar al contenido
Codex DesignBETA

Skills de Codex.

Una skill de Codex es una carpeta con un archivo SKILL.md que le enseña a Codex un tipo de trabajo, como arreglar el CI o revisar un diseño. Esta guía explica dónde se guardan las skills, cómo instalarlas y llamarlas, cómo escribir una que Codex elija en el momento justo y cuáles instalar primero.

Actualizado el 12 de noviembre de 2026 · 7 min de lectura

La respuesta corta

  • Una skill es una carpeta con un archivo SKILL.md: un name, una description e instrucciones en Markdown. También puede incluir scripts y archivos de referencia.
  • Para instalarla, escribe $skill-installer y el nombre de la skill o su URL de GitHub en Codex, o copia la carpeta en ~/.agents/skills. Reinicia Codex después.
  • Para usarla, ejecuta /skills o escribe $ y su nombre. Codex también elige una skill por su cuenta cuando tu petición encaja con su descripción.
  • Para escribir una, usa la skill integrada $skill-creator. La descripción decide cuándo la usa Codex, así que dedícale la mayor parte del tiempo.
  • El catálogo openai/skills de OpenAI está obsoleto. Las nuevas skills oficiales vienen dentro de plugins, en el repositorio openai/plugins.

Qué es una skill de Codex

Una skill empaqueta instrucciones, y opcionalmente scripts y recursos, para una tarea concreta. Al empezar una sesión, Codex solo lee el nombre y la descripción de cada skill. Cuando una tarea encaja con una descripción, o cuando mencionas la skill, carga el SKILL.md completo. Por eso puedes tener decenas de skills instaladas sin llenar la ventana de contexto.

Las skills siguen el formato abierto Agent Skills, así que la misma carpeta suele funcionar en otros agentes que leen SKILL.md, como Claude Code. Un plugin es otra cosa: un paquete instalable que puede contener varias skills, además de servidores MCP y hooks. Consulta Plugins vs skills en Codex para ver la diferencia.

Dónde se guardan las skills de Codex

ÁmbitoRutaPara qué sirve
Repositorio.agents/skills en la carpeta actual o en una superior, hasta la raíz del repositorioSkills que pertenecen a un solo proyecto
Usuario~/.agents/skillsSkills que quieres en todos tus proyectos
Organización/etc/codex/skillsSkills que un administrador instala para todos
SistemaVienen con Codexskill-creator, skill-installer y algunas más

Codex revisa cada carpeta .agents/skills desde donde lo iniciaste hasta la raíz del repositorio. Dos skills con el mismo nombre no se fusionan: ambas aparecen en la lista. Las carpetas de skills con enlaces simbólicos funcionan, lo cual es útil si guardas tus skills en un único repositorio de Git.

Cómo usar una skill

  • Elígela: ejecuta /skills en Codex CLI o en la extensión para IDE y escoge una.
  • Menciónala: escribe $ y el nombre de la skill en tu prompt, por ejemplo $gh-fix-ci the build on this branch is red.
  • Deja que Codex elija: describe la tarea con normalidad. Si encaja con la descripción de una skill, Codex la carga por sí mismo.

En la app de escritorio de ChatGPT, escribe @ en lugar de $.

Cómo instalar skills de Codex

Con $skill-installer

$skill-installer es una skill del sistema que viene con Codex. Pásale un nombre o una carpeta de GitHub:

$skill-installer gh-address-comments
$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui

Un nombre a secas instala desde el catálogo curado de OpenAI. Una URL instala desde cualquier repositorio público. Reinicia Codex si la skill nueva no aparece.

Copiando la carpeta

Una skill son solo archivos, así que también puedes clonar o copiar su carpeta en ~/.agents/skills (todos los proyectos) o en .agents/skills (un solo proyecto). Es la forma más sencilla de compartir una skill con tu equipo: súbela al repositorio y todos los que abran el proyecto en Codex la tendrán.

Desde un plugin

OpenAI ha declarado obsoleto el repositorio openai/skills y ahora distribuye sus propias skills dentro de plugins, en el repositorio openai/plugins: Figma, Notion, Linear, GitHub, Vercel, Build Web Apps, Product Design y más. Ejecuta /plugins en Codex CLI para explorarlos e instalarlos. Un plugin instala sus skills y las herramientas que necesitan en un solo paso.

Cómo escribir tu propia skill

La forma más rápida de empezar es pedírselo a Codex:

Crea una skill con $skill-creator
$skill-creator Crea una skill de usuario llamada design-review. Revisa una pantalla de UI según el DESIGN.md del proyecto: colores y fuentes solo los del archivo, una cuadrícula de espaciado de 8px, texto del cuerpo de 16px o más, y ningún emoji como icono. Informa de los problemas en una lista con el archivo y la línea, y luego los corrige.

O escribe el archivo tú mismo, en ~/.agents/skills/design-review/SKILL.md:

---
name: design-review
description: Review a UI screen against the project's DESIGN.md. Use when the user asks for a design review, says a screen looks off, or before finishing any UI change.
---

1. Read DESIGN.md. If there is none, say so and stop.
2. Check colors, fonts, spacing, and type sizes against it.
3. List each problem with the file and line, then fix it.

Tres cosas marcan la diferencia entre una skill que Codex usa y otra que ignora:

  • Escribe la descripción para que encaje. Di qué hace la skill y cuándo usarla, con las palabras que la gente escribe de verdad. “Use when the user asks for a design review” funciona; “Design helper” no.
  • Mantén SKILL.md corto. Pon las referencias largas en una carpeta references/ e indica a la skill cuándo leerlas. Codex carga los archivos adicionales solo cuando hacen falta.
  • Usa scripts para los pasos exactos. Si algo debe hacerse siempre igual, como una comprobación o una conversión, ponlo en scripts/ y haz que la skill lo ejecute.

Para que Codex no use una skill por su cuenta pero $nombre siga funcionando, añade agents/openai.yaml a la carpeta de la skill con policy: { allow_implicit_invocation: false }.

Skills de Codex que conviene instalar

SkillQué haceCómo conseguirla
skill-creator, skill-installerCrean e instalan skillsIntegradas
imagegenGenera imágenes a partir de un prompt dentro de CodexIntegrada
gh-fix-ciLee los logs fallidos de GitHub Actions y arregla la compilación$skill-installer gh-fix-ci
gh-address-commentsResuelve uno a uno los comentarios de revisión de tu pull request abierta$skill-installer gh-address-comments
playwrightManeja un navegador real para probar y capturar lo que Codex construyó$skill-installer playwright
security-best-practicesRevisa el código en busca de errores de seguridad habituales$skill-installer security-best-practices
Skills de FigmaConvierten frames de Figma en código y código en FigmaEl plugin de Figma, desde /plugins
Taste SkillAleja la UI del aspecto genérico de la IAConsulta el tutorial
pretty-uiDetecta en la UI los rasgos típicos de diseño hecho con IA y los corrige$skill-installer install https://github.com/ummydev/pretty-ui/tree/main/skills/pretty-ui

Para el trabajo de diseño en concreto, comparamos las opciones en las mejores skills de Codex para diseño UI y en Taste Skill vs Impeccable vs UI UX Pro Max.

Desactiva una skill o arregla una que no aparece

Para desactivar una skill sin borrarla, añade esto a ~/.codex/config.toml y reinicia Codex:

[[skills.config]]
path = "/Users/you/.agents/skills/design-review/SKILL.md"
enabled = false

Usa name = "design-review" en lugar de path para desactivar todas las skills con ese nombre.

Si una skill no aparece en /skills:

  • Reinicia Codex. Las skills nuevas se cargan al iniciar una sesión.
  • Revisa la carpeta. El archivo debe llamarse SKILL.md y estar directamente dentro de la carpeta de la skill, en una de las rutas indicadas arriba.
  • Revisa el frontmatter. name y description son obligatorios.
  • Puede que tengas demasiadas. La lista inicial de skills recibe cerca del 2 % de la ventana de contexto. Si se supera, Codex acorta las descripciones y puede dejar skills fuera, con una advertencia. Aumenta el límite con skills.max_context_tokens en config.toml, o elimina las skills que no uses.

Preguntas frecuentes

¿Las skills de Claude Code funcionan en Codex?

Normalmente, sí. Ambos usan el formato SKILL.md. Copia la carpeta de ~/.claude/skills a ~/.agents/skills. Una skill que le indica al agente usar una herramienta que solo tiene uno de los dos habrá que editarla.

¿Cuál es la diferencia entre una skill y AGENTS.md?

AGENTS.md se carga en todas las sesiones de ese proyecto, así que sirve para las reglas que siempre se aplican. Una skill se carga solo cuando una tarea la necesita, así que sirve para los flujos de trabajo que usas de vez en cuando, y puede incluir scripts y archivos de referencia.

¿Dónde encuentro más skills de Codex?

En los plugins de OpenAI desde /plugins, en el repositorio openai/skills (obsoleto, pero todavía legible) y en las skills que sus autores publican en GitHub. Lee los archivos de una skill antes de instalarla, sobre todo sus scripts: una skill se ejecuta con el mismo acceso que tiene Codex.

Sigue leyendo

Un plugin independiente para Codex. No está afiliado a OpenAI ni cuenta con su respaldo.