Skills en Codex

Codex CLI (OpenAI) soporta Agent Skills: paquetes de instrucciones que el agente carga bajo demanda para tareas específicas (integrar Linear, hacer code review, usar tu propio SDK, etc.). Están basadas en el mismo estándar abierto de Anthropic, así que una skill escrita para Claude Code también funciona en Codex.

Invocar una skill

Dentro de una sesión de Codex:

Codex

$nombre-skill

O lista las disponibles:

Codex

/skills

Dónde viven las skills

Ubicación	Alcance
`.agents/skills/`	Del proyecto actual
`$HOME/.agents/skills/`	Personal
`/etc/codex/skills/`	Administradas por la organización

Skills built-in

Codex viene con dos skills muy útiles listas para usar:

$skill-creator
$skill-installer

Te guía paso a paso para crear una nueva skill: pregunta qué hace, dónde debe vivir, genera el SKILL.md con la estructura correcta y lo prueba.

Codex

$skill-creator

Instala una skill del marketplace oficial.

Codex

$skill-installer linear
$skill-installer github

Crear una skill a mano

Crear la carpeta

Terminal

mkdir -p .agents/skills/desplegar-staging

Escribir SKILL.md

SKILL.md

---
name: desplegar-staging
description: Despliega la rama actual al entorno de staging usando el script deploy.sh. Úsalo cuando pidan "deploy a staging" o "subir a QA".
---

# Desplegar a staging

1. Verifica que la rama actual no sea `main`.
2. Ejecuta `./scripts/deploy.sh staging`.
3. Reporta la URL de staging cuando termine.
4. Si falla, muestra los últimos 20 logs.

Invocarla

Codex

$desplegar-staging

Estructura de una skill

.agents/skills/mi-skill/
├── SKILL.md              # Requerido
├── scripts/              # Opcional
├── references/           # Opcional
└── assets/               # Opcional

Frontmatter

SKILL.md

---
name: mi-skill
description: Qué hace y cuándo debe usarse. Codex lee esto para saber si aplicar la skill.
---

Escribí la description como si le hablaras al agente: “úsalo cuando el usuario pida X” funciona mejor que descripciones genéricas.

AGENTS.md: instrucciones siempre activas

A diferencia de las skills (que se cargan bajo demanda), AGENTS.md se lee al inicio de cada sesión. Úsalo para reglas globales:

Ubicación	Cuándo se usa
`~/.codex/AGENTS.md`	Reglas personales globales
`AGENTS.md` (raíz del repo)	Reglas del equipo para ese proyecto

Ejemplo mínimo:

AGENTS.md

- Usá TypeScript strict siempre que sea posible.
- No hagas commits directos a `main`.
- Los tests van en `__tests__/` al lado del archivo.

Agent Skills

Invocar una skill

Dónde viven las skills

Skills built-in

Crear una skill a mano

Estructura de una skill

Frontmatter

AGENTS.md: instrucciones siempre activas

Recursos

Codex CLI

Agent Skills en Codex

​Invocar una skill

​Dónde viven las skills

​Skills built-in

​Crear una skill a mano

​Estructura de una skill

​Frontmatter

​AGENTS.md: instrucciones siempre activas

​Recursos

Codex CLI

Agent Skills en Codex

Invocar una skill

Dónde viven las skills

Skills built-in

Crear una skill a mano

Estructura de una skill

Frontmatter

AGENTS.md: instrucciones siempre activas

Recursos