Crear habilidades

Usa habilidades de agente para ampliar ChatGPT y Codex con capacidades específicas para cada tarea. Una habilidad agrupa instrucciones, recursos y scripts opcionales para que cualquiera de los dos productos pueda seguir un flujo de trabajo de forma fiable. Las habilidades se basan en el estándar abierto de habilidades de agente.

Las habilidades son el formato de creación de flujos de trabajo reutilizables. Los plugins distribuyen habilidades y conectores reutilizables mediante el directorio universal de plugins compartido por ChatGPT y Codex. Los plugins funcionan en Chat y Work en ChatGPT para la web, el escritorio y los dispositivos móviles, en Codex dentro de la aplicación de escritorio ChatGPT y mediante Codex CLI. Usa habilidades para diseñar el propio flujo de trabajo y, después, empaquétalo como plugin cuando quieras que otras personas lo instalen.

Las habilidades independientes están disponibles en la aplicación de escritorio ChatGPT, Codex CLI y la extensión de IDE. Las habilidades incluidas en plugins también están disponibles en Chat y Work en ChatGPT para la web, el escritorio y los dispositivos móviles.

En la aplicación de escritorio ChatGPT, abre Habilidades en la barra lateral para ver y explorar las habilidades creadas en tus proyectos.

Selector de habilidades que muestra las habilidades disponibles en la aplicación de escritorio ChatGPT (modo claro)

Las habilidades usan la **divulgación progresiva** para gestionar el contexto de manera eficiente. ChatGPT y Codex comienzan con el nombre y la descripción de cada habilidad y, después, cargan las instrucciones completas de `SKILL.md` cuando deciden usar esa habilidad.

En Codex, la lista inicial también incluye la ruta de archivo de cada habilidad. Para evitar que ocupe el espacio del resto del prompt, esta lista usa como máximo el 2 % de la ventana de contexto del modelo, o 8.000 caracteres cuando se desconoce el tamaño de la ventana de contexto. Si hay muchas habilidades instaladas, Codex acorta primero sus descripciones. En conjuntos grandes de habilidades, Codex puede omitir algunas de la lista inicial y mostrar una advertencia.

Este límite se aplica únicamente a la lista inicial de habilidades. Cuando Codex selecciona una habilidad, sigue leyendo las instrucciones completas de SKILL.md correspondientes.

Una habilidad es un directorio con un archivo SKILL.md y scripts y referencias opcionales. El archivo SKILL.md debe incluir name y description.

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 la extensión para IDE, ejecuta /skills o escribe $ para mencionar una habilidad.
Invocación implícita: ChatGPT o Codex pueden elegir una habilidad cuando tu tarea coincide con la description de la habilidad.

Como la coincidencia implícita depende de description, escribe descripciones concisas con un alcance y unos límites claros. Coloca al principio el caso de uso principal y las palabras clave de activación para que un host pueda seguir encontrando coincidencias con la habilidad si se acortan las descripciones.

Crear una habilidad

Si ya conoces el flujo de trabajo y es más fácil mostrarlo que describirlo, usa Grabar y reproducir. El grabador 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 como @skill-creator. En Codex, invócalo así:

$skill-creator

El creador pregunta qué hace la habilidad, cuándo debe activarse y si debe contener solo instrucciones o incluir scripts. El valor predeterminado es que solo contenga instrucciones.

También puedes crear una habilidad manualmente mediante la creación de 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.

Dónde carga Codex las habilidades locales

Codex lee habilidades de ubicaciones del repositorio, del usuario, administrativas y del sistema. En los repositorios, Codex busca .agents/skills en todos los directorios desde el directorio de trabajo actual hasta la raíz del repositorio. Si dos habilidades comparten el mismo name, Codex no las combina; ambas pueden aparecer en los selectores de habilidades.

Ámbito de la habilidad	Ubicación	Uso recomendado
`REPO`	`$CWD/.agents/skills` Directorio de trabajo actual: donde inicia Codex.	Si está en un repositorio o entorno de código, los equipos pueden incorporar habilidades pertinentes para una carpeta de trabajo. Por ejemplo, habilidades pertinentes solo para un microservicio o módulo.
`REPO`	`$CWD/../.agents/skills` Una carpeta superior al CWD cuando inicia Codex dentro de un repositorio de Git.	Si está en un repositorio con carpetas anidadas, las organizaciones pueden incorporar habilidades pertinentes para un área compartida de una carpeta principal.
`REPO`	`$REPO_ROOT/.agents/skills` La carpeta raíz de nivel más alto cuando inicia Codex dentro de un repositorio de Git.	Si está en un repositorio con carpetas anidadas, las organizaciones pueden incorporar habilidades pertinentes para todos los usuarios del repositorio. Estas actúan como habilidades raíz disponibles para cualquier subcarpeta del repositorio.
`USER`	`$HOME/.agents/skills` Cualquier habilidad incorporada en la carpeta personal del usuario.	Úsela para seleccionar habilidades pertinentes para un usuario que se apliquen a cualquier repositorio en el que este pueda trabajar.
`ADMIN`	`/etc/codex/skills` Cualquier habilidad incorporada en una ubicación compartida del sistema en la máquina o el contenedor.	Úsela para scripts de SDK, automatización y para incorporar habilidades administrativas predeterminadas disponibles para cada usuario de la máquina.
`SYSTEM`	Incluida con Codex por OpenAI.	Habilidades útiles para un público amplio, como las habilidades de creación de habilidades y planificación. Disponibles para todos cuando inician Codex.

Codex admite carpetas de habilidades con enlaces simbólicos y sigue el destino del enlace al examinar estas ubicaciones.

Estas ubicaciones sirven para la creación y la detección local. Cuando quieras distribuir habilidades reutilizables más allá de un único repositorio o, de manera opcional, agruparlas con conectores, usa plugins.

Distribuir habilidades mediante plugins

Las carpetas de habilidades directas son la mejor opción para la creación local y los flujos de trabajo limitados al repositorio. Si quieres distribuir una habilidad reutilizable, agrupar dos o más habilidades o incluir una habilidad junto con un conector, empaquétalas como un plugin.

Los plugins pueden incluir una o más habilidades. También pueden agrupar opcionalmente conexiones registradas a servidores MCP, configuraciones incluidas de servidores MCP y recursos para presentaciones en un solo paquete.

Instalar habilidades seleccionadas para uso local

Para añadir a tu configuración local de Codex habilidades seleccionadas además de las integradas, usa $skill-installer. Por ejemplo, para instalar la habilidad $linear:

$skill-installer linear

También puedes pedir al instalador que descargue habilidades desde otros repositorios. Codex detecta automáticamente las habilidades recién instaladas; si alguna no aparece, reinicie Codex.

Usa esta opción para la configuración local y la experimentación. Para distribuir tus propias habilidades de forma reutilizable, prefiere los plugins.

Activar o desactivar 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 = false

Reinicia Codex después de modificar ~/.codex/config.toml.

Metadatos opcionales

Añade 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 dependencias de herramientas para que el uso de la habilidad resulte más fluido.

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): Cuando es false, Codex no invoca implícitamente la habilidad según la solicitud del usuario; la invocación explícita $skill sigue funcionando.

Prácticas recomendadas

Centra cada habilidad en una sola tarea.
Prefiere las instrucciones a los scripts, salvo que necesites un comportamiento determinista o herramientas externas.
Escribe pasos en imperativo con entradas y salidas explícitas.
Prueba solicitudes con la descripción de la habilidad para confirmar que se activa correctamente.

Para consultar más ejemplos, consulta Reparación de CI de GitHub, PDF, Linear, openai/skills y la especificación de habilidades de agentes. Para la distribución instalable, prefiere los plugins.

Búsquedas recientes

Búsquedas sugeridas

Navegación de la documentación