Documentación de ChatGPT
Español
Contacto goolvyouyou@gmail.com

Crear habilidades

Proporcione a Codex nuevas capacidades y conocimientos especializados

Use habilidades de agente para ampliar Codex con capacidades específicas para cada tarea. Una habilidad empaqueta instrucciones, recursos y scripts opcionales para que Codex 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 a ChatGPT Work en la web y a ChatGPT Work y Codex en la aplicación de escritorio. Codex CLI también puede instalar plugins. Use habilidades para diseñar el propio flujo de trabajo y, después, empaquételo como un plugin cuando quiera que otras personas de su espacio de trabajo lo instalen.

Las habilidades están disponibles en la aplicación de escritorio de ChatGPT, Codex CLI y la extensión de IDE.

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

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

Las habilidades usan la divulgación progresiva para administrar el contexto de forma eficiente: Codex comienza con el nombre, la descripción y la ruta de archivo de cada habilidad. Codex solo carga las instrucciones completas de SKILL.md cuando decide usar una habilidad.

Codex incluye en el contexto una lista inicial de habilidades disponibles para poder elegir la adecuada para una tarea. Para evitar que esta desplace el resto de la solicitud, la lista usa como máximo el 2 % de la ventana de contexto del modelo o 8000 caracteres cuando se desconoce el tamaño de dicha ventana. Si hay muchas habilidades instaladas, Codex acorta primero sus descripciones. En conjuntos grandes, Codex puede omitir algunas habilidades 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.

my-skill/
├── SKILL.md          # Required: instructions and metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates and resources
└── agents/
    └── openai.yaml   # Optional: appearance and dependency declarations

Cómo usa Codex las habilidades

Codex puede activar habilidades de dos maneras:

  1. Invocación explícita: Incluya la habilidad directamente en su solicitud. En CLI/IDE, ejecute /skills o escriba $ para mencionar una habilidad.
  2. Invocación implícita: Codex puede elegir una habilidad cuando la tarea coincida con el description de la habilidad.

Como la coincidencia implícita depende de description, escriba descripciones concisas con un ámbito y unos límites claros. Coloque al principio el caso de uso principal y las palabras desencadenantes para que Codex pueda seguir encontrando la habilidad si se acortan las descripciones.

Crear una habilidad

Si ya conoce el flujo de trabajo y resulta más fácil mostrarlo que describirlo, use Grabar y reproducir. Codex graba el flujo de trabajo, inspecciona los pasos y prepara una habilidad reutilizable a partir de la demostración.

Si prefiere describir la habilidad, use el creador integrado:

$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 puede 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 Codex to follow.

Codex detecta automáticamente los cambios en las habilidades. Si una actualización no aparece, reinicie Codex.

Dónde guardar las habilidades

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 el descubrimiento local. Cuando quiera distribuir habilidades reutilizables más allá de un único repositorio o agruparlas opcionalmente con conectores, use plugins.

Distribuir habilidades mediante plugins

Las carpetas de habilidades directas son más adecuadas para la creación local y los flujos de trabajo limitados a un repositorio. Si quiere distribuir una habilidad reutilizable, agrupar dos o más habilidades o entregar una habilidad junto con un conector, empaquételas como un plugin.

Los plugins pueden incluir una o varias habilidades. También pueden agrupar opcionalmente asignaciones de aplicaciones, configuración de servidores MCP y recursos de presentación en un único paquete.

Instalar habilidades seleccionadas para uso local

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

$skill-installer linear

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

Use esta opción para la configuración local y la experimentación. Para distribuir sus propias habilidades de forma reutilizable, prefiera los plugins.

Habilitar o deshabilitar habilidades

Use entradas [[skills.config]] en ~/.codex/config.toml para deshabilitar una habilidad sin eliminarla:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

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

Metadatos opcionales

Añada 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

  • Centre cada habilidad en una sola tarea.
  • Prefiera las instrucciones a los scripts, salvo que necesite un comportamiento determinista o herramientas externas.
  • Escriba pasos en imperativo con entradas y salidas explícitas.
  • Pruebe solicitudes con la descripción de la habilidad para confirmar que se activa correctamente.

Para obtener más ejemplos, consulte Reparación de CI de GitHub, PDF, Linear, openai/skills y la especificación de habilidades de agente. Para la distribución instalable, prefiera los plugins.