Usa habilidades de agente para ampliar las capacidades de ChatGPT y Codex en tareas específicas. Una habilidad reúne instrucciones, recursos y scripts opcionales para que cualquiera de los dos productos pueda seguir un flujo de trabajo de manera confiable. Las habilidades se basan en el estándar abierto de habilidades de agente.
Las habilidades son el formato que se usa para crear flujos de trabajo reutilizables. Los complementos distribuyen habilidades reutilizables y conectores a través del directorio universal de complementos que comparten ChatGPT y Codex. Los complementos funcionan en los modos Chat y Work de ChatGPT en la web, en computadoras de escritorio y en dispositivos móviles. También funcionan en Codex dentro de la aplicación de escritorio de ChatGPT y en Codex CLI. Usa una habilidad para diseñar el flujo de trabajo y luego empaquétala como complemento cuando quieras que otras personas puedan instalarla.
Las habilidades independientes están disponibles en la aplicación de escritorio de ChatGPT, en Codex CLI y en la extensión para IDE. Las habilidades incluidas en complementos también están disponibles en los modos Chat y Work de ChatGPT en la web, en computadoras de escritorio y en dispositivos móviles.
En la aplicación de escritorio de ChatGPT, abre Habilidades en la barra lateral para ver y explorar las habilidades creadas en tus proyectos.
Las habilidades usan la divulgación progresiva para gestionar el contexto de forma eficiente. Al principio, ChatGPT y Codex consultan el nombre y la descripción de cada habilidad. Cuando deciden usarla, cargan todas las instrucciones de SKILL.md.
En Codex, la lista inicial también incluye la ruta del archivo de cada habilidad. De forma predeterminada, la lista ocupa como máximo el 2 % de la ventana de contexto del modelo, o 8000 caracteres si se desconoce el tamaño de la ventana. Si hay muchas habilidades instaladas, Codex primero acorta sus descripciones. Si el conjunto de habilidades es grande, Codex puede omitir algunas de la lista inicial y mostrar una advertencia.
Usa skills.max_context_tokens para establecer otro límite de hasta 10 000 tokens.
Este límite solo se aplica a la lista inicial de habilidades. Cuando Codex selecciona una habilidad, lee todas las instrucciones de su archivo SKILL.md.
Una habilidad es un directorio que contiene un archivo SKILL.md y, de manera opcional, scripts y referencias. El archivo SKILL.md debe incluir name y description.
-
my-skill/
- SKILL.md Obligatorio: instrucciones y metadatos
- scripts/ Opcional: código ejecutable
- references/ Opcional: documentación
- assets/ Opcional: plantillas y recursos
-
agents/
- openai.yaml Opcional: apariencia y dependencias
-
-
Cómo usan las habilidades ChatGPT y Codex
ChatGPT y Codex pueden activar habilidades de dos maneras:
- Invocación explícita: incluye la habilidad directamente en tu prompt. En ChatGPT, escribe
@para seleccionar una habilidad. En Codex CLI o en la extensión para IDE, ejecuta/skillso escribe$para mencionar una habilidad. - Invocación implícita: ChatGPT o Codex pueden elegir una habilidad cuando tu tarea coincide con lo indicado en su campo
description.
Como la selección implícita depende de description, escribe descripciones concisas que indiquen claramente el alcance y los límites de cada habilidad. Coloca al principio el caso de uso principal y las palabras que activan la habilidad para que el host pueda identificarla incluso si se acortan las descripciones.
Crear una habilidad
Si ya conoces el flujo de trabajo y te resulta más fácil mostrarlo que describirlo, usa Grabar y reproducir. La grabadora captura el flujo de trabajo, examina los pasos y crea un borrador de una habilidad reutilizable a partir de la demostración.
Si prefieres describir la habilidad, usa el creador integrado. En ChatGPT Work, invócalo con @skill-creator. En Codex, invócalo así:
$skill-creatorEl creador te pregunta qué hace la habilidad, cuándo debe activarse y si debe contener solo instrucciones o incluir también scripts. De forma predeterminada, solo contiene instrucciones.
También puedes crear una habilidad manualmente. Para ello, crea una carpeta con un archivo SKILL.md:
---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---
Skill instructions for ChatGPT or Codex to follow.Codex detecta automáticamente los cambios en las habilidades. Si una actualización no aparece, reinicia Codex.
Desde dónde carga Codex las habilidades locales
Codex lee las habilidades desde ubicaciones del repositorio, del usuario, del administrador y del sistema. En los repositorios, Codex examina .agents/skills en cada directorio, desde el directorio de trabajo actual hasta la raíz del repositorio. Si dos habilidades tienen el mismo name, Codex las mantiene separadas y ambas pueden aparecer en los selectores de habilidades.
| Alcance de la habilidad | Ubicación | Uso sugerido |
|---|---|---|
REPO |
$CWD/.agents/skills El directorio de trabajo actual, desde donde inicias Codex. |
En un repositorio o entorno de desarrollo, los equipos pueden incorporar al control de versiones habilidades específicas de una carpeta de trabajo, por ejemplo, habilidades que solo se aplican a un microservicio o módulo. |
REPO |
$CWD/../.agents/skills La carpeta inmediatamente superior al directorio de trabajo actual cuando inicias Codex dentro de un repositorio de Git. |
En un repositorio con carpetas anidadas, las organizaciones pueden incorporar al control de versiones, en una carpeta superior, habilidades para un área compartida. |
REPO |
$REPO_ROOT/.agents/skills La carpeta raíz del repositorio cuando inicias Codex dentro de un repositorio de Git. |
En un repositorio con carpetas anidadas, las organizaciones pueden incorporar al control de versiones habilidades para todas las personas que usan el repositorio. Estas habilidades de la raíz están disponibles en cualquier subcarpeta del repositorio. |
USER |
$HOME/.agents/skills Habilidades guardadas bajo control de versiones en la carpeta personal del usuario. |
Usa esta ubicación para seleccionar habilidades que el usuario pueda usar en cualquier repositorio en el que trabaje. |
ADMIN |
/etc/codex/skills Habilidades guardadas bajo control de versiones en una ubicación compartida del sistema, ya sea en la máquina o en el contenedor. |
Usa esta ubicación para scripts del SDK, automatizaciones y habilidades predeterminadas del administrador que quieras incorporar al control de versiones y poner a disposición de todos los usuarios de la máquina. |
SYSTEM |
OpenAI las incluye con Codex. | Incluye skill-creator y skill-installer. Las habilidades del sistema están habilitadas de forma predeterminada. |
Codex admite enlaces simbólicos a carpetas de habilidades. Al examinar estas ubicaciones, sigue el enlace hasta la carpeta de destino.
Estas ubicaciones sirven para crear habilidades y encontrarlas localmente. Cuando quieras distribuir habilidades reutilizables más allá de un solo repositorio o incluir conectores en el mismo paquete, usa complementos.
Distribuir habilidades con complementos
Las carpetas de habilidades son la mejor opción para crear habilidades localmente y definir flujos de trabajo específicos de un repositorio. Si quieres distribuir una habilidad reutilizable, agrupar dos o más habilidades o distribuir una habilidad junto con un conector, empaqueta esos elementos como complemento.
Los complementos pueden incluir una o más habilidades. También pueden reunir en un solo paquete conexiones registradas a servidores MCP, la configuración de los servidores MCP incluidos y recursos de presentación.
Instalar habilidades seleccionadas para uso local
Para agregar habilidades seleccionadas a tu configuración local de Codex, además de las que ya vienen integradas, usa $skill-installer. Por ejemplo, para instalar la habilidad $linear, ejecuta lo siguiente:
$skill-installer linearTambién puedes pedirle al instalador que descargue habilidades de otros repositorios. Codex detecta automáticamente las habilidades recién instaladas. Si alguna no aparece, reinicia Codex.
Usa el instalador para configurar tu entorno local y experimentar. Para distribuir tus propias habilidades de modo que otras personas puedan reutilizarlas, da preferencia a los complementos.
Habilitar o deshabilitar habilidades locales de Codex
Usa entradas [[skills.config]] en ~/.codex/config.toml para deshabilitar una habilidad sin eliminarla:
[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = falseUsa exactamente un selector por entrada. Si especificas una ruta absoluta en path, la entrada se aplica a un solo archivo SKILL.md. Si usas name, la entrada se aplica a todas las habilidades con ese nombre. Si varias entradas coinciden con una habilidad, prevalece la última que coincida.
Para deshabilitar todas las habilidades del sistema incluidas con Codex en el proyecto actual, agrega esta opción al archivo de configuración de confianza .codex/config.toml de ese proyecto:
[skills.bundled]
enabled = falseReinicia Codex después de modificar la configuración.
Metadatos opcionales
Agrega agents/openai.yaml para configurar los metadatos de la interfaz en la aplicación de escritorio de ChatGPT, establecer la política de invocación y declarar las herramientas de las que depende la habilidad para facilitar su uso.
interface:
display_name: "Optional user-facing name"
short_description: "Optional user-facing description"
icon_small: "./assets/small-logo.svg"
icon_large: "./assets/large-logo.png"
brand_color: "#3B82F6"
default_prompt: "Optional surrounding prompt to use the skill with"
policy:
allow_implicit_invocation: false
dependencies:
tools:
- type: "mcp"
value: "openaiDeveloperDocs"
description: "OpenAI Docs MCP server"
transport: "streamable_http"
url: "https://developers.openai.com/mcp"allow_implicit_invocation (valor predeterminado: true): si el valor es false, Codex no invoca la habilidad de forma implícita a partir del prompt del usuario. Aun así, puedes invocarla explícitamente con $skill.
Buenas prácticas
- Dedica cada habilidad a una sola tarea.
- Da preferencia a las instrucciones frente a los scripts, salvo que necesites un comportamiento determinista o herramientas externas.
- Redacta los pasos en imperativo e indica explícitamente las entradas y salidas.
- Prueba distintos prompts con la descripción de la habilidad para verificar que se active cuando corresponda.
Para ver más ejemplos, consulta Reparar fallas de CI en GitHub, PDF, Linear, openai/skills y la especificación de habilidades de agente. Para distribuir habilidades que otras personas puedan instalar, da preferencia a los complementos.