Codex CLI — Skills · Agentes de IA para programar

Codex admite skills de agente construidas sobre el estándar abierto de agent skills: flujos de trabajo empaquetados y reutilizables que Codex puede cargar bajo demanda.

Estructura de SKILL.md

Una skill es un directorio con un SKILL.md que lleva frontmatter obligatorio (name, description), más archivos de apoyo opcionales:

mi-skill/
├── SKILL.md          # obligatorio: frontmatter con name y description
├── scripts/          # scripts auxiliares, opcional
├── references/       # material de referencia, opcional
├── assets/           # recursos, opcional
└── agents/
    └── openai.yaml   # metadatos de interfaz, policy.allow_implicit_invocation
                      # y dependencias de herramientas/MCP, opcional

---
name: changelog-writer
description: Redacta una entrada de changelog a partir de los commits desde el último tag
---

# Redactor de changelog

1. Ejecuta `git log --oneline $(git describe --tags --abbrev=0)..HEAD`.
2. Agrupa los commits por tipo (feat, fix, chore).
3. ...

Revelación progresiva: al principio Codex sólo ve el nombre, la descripción y la ruta de cada skill (con un tope del 2% de la ventana de contexto del modelo, u 8.000 caracteres si no se conoce; ajustable con skills.max_context_tokens, con un máximo de 10.000 tokens). El SKILL.md completo se lee sólo cuando la skill se usa de verdad.

Rutas de descubrimiento

Codex escanea .agents/skills desde el directorio actual hasta la raíz del repositorio (siguiendo enlaces simbólicos):

Ámbito	Ubicación
Repositorio	`$CWD/.agents/skills` y cada directorio hasta `$REPO_ROOT/.agents/skills`
Usuario	`$HOME/.agents/skills`
Administrador	`/etc/codex/skills`
Sistema	Las que vienen con Codex (por ejemplo `skill-creator` y las skills de planificación)

Ojo: las skills viven bajo .agents/skills — no en .codex/skills. Y <writable_root>/.agents es una ruta protegida de solo lectura en el modo de sandbox workspace-write.

Cómo se invocan

Explícitamente: /skills en la TUI para explorarlas y elegir una, o mencionando $nombre-de-la-skill en un prompt.
Implícitamente: Codex elige una skill por su cuenta cuando la tarea encaja con su description (salvo que la skill restrinja la invocación implícita).

Ayudantes incluidos:

$skill-creator — crea una skill nueva de forma interactiva.
$skill-installer — instala una skill, por ejemplo $skill-installer linear.

Para desactivar una skill sin borrarla, en ~/.codex/config.toml:

[[skills.config]]
path = "/Users/tu-usuario/.agents/skills/changelog-writer/SKILL.md"
enabled = false

Distribución mediante plugins

Los plugins distribuyen skills (y opcionalmente servidores MCP y conectores) a través de marketplaces:

codex plugin marketplace add owner/repo
codex plugin add <plugin>
codex plugin list
codex plugin remove <plugin>

Los orígenes de un plugin pueden ser la forma corta de GitHub (owner/repo[@ref]), URLs de Git o directorios locales (--ref, --sparse). Los servidores MCP que trae un plugin se configuran bajo plugins.<plugin>.mcp_servers.<servidor>.

Última verificación: 2026-09-07

Fuentes oficiales:

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.