Ir al contenido principal
Español— Elegir un idioma
Menú

Escribe una habilidad reutilizable

Lección 17 de 17 Actualizado el 5 de noviembre de 2026 Intermedio
En esta página
  1. La anatomía de una habilidad
  2. La descripción es la pieza clave
  3. Configuración opcional
  4. Dónde residen las habilidades y cómo compartirlas
  5. Tu turno
  6. Puntos clave
  7. Pon a prueba tus conocimientos

Si las instrucciones de un GPT son su corazón, la habilidad es el corazón de un complemento. Es el formato que utilizas para escribir un flujo de trabajo reutilizable: instrucciones, recursos y scripts si fueran necesarios. Las habilidades de OpenAI siguen un estándar abierto llamado «agent skills» (agentskills.io), lo que significa que una habilidad bien escrita no está bloqueada en una única herramienta. Esta lección te enseña a escribir una.

La anatomía de una habilidad

Una habilidad es una carpeta que contiene un archivo obligatorio, SKILL.md, y elementos opcionales.

synthese-document/
├── SKILL.md          ← obligatorio: instrucciones + metadatos
├── scripts/          ← opcional: código ejecutable
├── references/       ← opcional: documentación
├── assets/           ← opcional: plantillas, recursos
└── agents/
    └── openai.yaml   ← opcional: apariencia y dependencias

El archivo SKILL.md debe incluir un name y una description. Aquí tienes un ejemplo mínimo:

---
name: synthese-document
description: Summarizes a provided document into three parts (overview, key points, open questions). Use when the user requests a summary or report of an attached document.
---

# Document Summary

1. Read the entire document before writing.
2. Write three sections: Overview (3 sentences), Key Points (max 5 bullets), Open Questions.
3. Rely only on the document; if information is missing, write "not provided."
4. Use the template in `assets/modele.md` for formatting.

La descripción es la pieza clave

ChatGPT y Codex activan una habilidad de dos formas. O bien la llamas explícitamente —escribiendo @ en ChatGPT, o /skills y $ en Codex—, o la herramienta la selecciona automáticamente cuando tu solicitud coincide con su descripción. Por eso la documentación hace hincapié en este campo: necesitas una descripción concisa que empiece con el caso de uso principal y las palabras desencadenantes, y que establezca claramente sus límites.

Un mecanismo específico impulsa este requisito: la divulgación progresiva. Inicialmente, ChatGPT y Codex solo leen el nombre y la descripción de cada habilidad instalada; cargan las instrucciones completas de SKILL.md solo cuando utilizan realmente la habilidad. Esto te permite instalar muchas habilidades sin saturar la ventana de contexto, pero también significa que una descripción vaga conduce a una habilidad que o bien nunca se elige en el momento adecuado, o se elige en el momento equivocado.

Configuración opcional

El archivo agents/openai.yaml te permite pulir la visualización en la aplicación de escritorio (nombre, descripción breve, iconos, color, indicación predeterminada), declarar las herramientas de las que depende la habilidad —un servidor MCP, por ejemplo— y establecer una política de invocación. Establecer allow_implicit_invocation: false evita que ChatGPT elija la habilidad por sí mismo: útil para flujos de trabajo sensibles que deseas activar solo bajo demanda.

Dónde residen las habilidades y cómo compartirlas

Una habilidad independiente funciona en la aplicación de escritorio de ChatGPT, en Codex mediante la línea de comandos y en su extensión de editor; en Codex, las habilidades del proyecto van en la carpeta .agents/skills del repositorio. Para poner una habilidad a disposición de otros, OpenAI recomienda empaquetarla en un complemento: un complemento puede agrupar varias habilidades y añadir conexiones a servidores MCP o elementos de presentación. Las habilidades incluidas en un complemento pasan a estar disponibles en los modos Chat y Work en ChatGPT, en la web, escritorio y móvil. En ChatGPT en la web, la pestaña Skills del directorio de complementos también te permite crear una habilidad mediante conversación (usando la habilidad integrada skill-creator), con un editor o por importación, y compartirla dentro de tu espacio de trabajo; esta pestaña está reservada para los planes elegibles Business, Enterprise, Healthcare y Edu.

La anatomía de una habilidad Tres bloques: SKILL.md, obligatorio, con el nombre, la descripción y las instrucciones; la carpeta references, opcional, para archivos de referencia; la carpeta scripts, opcional, para pasos automatizados. UNA CARPETA, UN ARCHIVO OBLIGATORIO La anatomía de una habilidad 1 SKILL.md Nombre, descripción, instrucciones. Obligatorio 2 references/ Archivos de referencia. Opcional 3 scripts/ Pasos automatizados. Opcional La descripción decide cuándo se activa la habilidad: indica cuándo usarla y cuándo no usarla.
Basado en la página Build skills de la documentación de ChatGPT (noviembre de 2026).

Tu turno

De GPT a habilidad. Toma las instrucciones del GPT que construiste en las lecciones 4 a 7. Transfórmalas en un SKILL.md: un nombre corto, una descripción que indique cuándo usarlo y cuándo no, pasos numerados y tus archivos de conocimiento almacenados en references/. Luego, prueba la habilidad dos veces: una llamándola con @, y otra con una solicitud normal que debería activarla.

Fuentes oficiales: Build skills (documentación de ChatGPT: SKILL.md, descripción, ubicaciones) · Skills in ChatGPT (Centro de ayuda de OpenAI: pestaña Skills, planes, uso compartido)

Puntos clave

  • Una habilidad es una carpeta con un SKILL.md (nombre + descripción obligatorios) y recursos opcionales; sigue el estándar abierto agent skills
  • La descripción decide cuándo se elige la habilidad: empieza con el caso de uso, las palabras desencadenantes y los límites
  • Divulgación progresiva: solo se leen primero el nombre y la descripción; las instrucciones se cargan en el momento del uso
  • Para compartir una habilidad, empaquétala en un complemento

Pon a prueba tus conocimientos

De GPTs a complementos: valida todo el recorrido.

1. Custom Instructions, Memory, GPT: ¿cuál es la diferencia?

Respuesta: Custom Instructions matiza todas tus conversaciones; Memory retiene datos sobre ti a lo largo del tiempo; un GPT es un asistente empaquetado —instrucciones, conocimiento, herramientas— compartible con otros.

2. ¿Qué debe contener una buena instrucción de sistema para un GPT?

Respuesta: El rol, el alcance (qué hace y qué no hace), el tono, el formato de respuesta y la gestión de casos límite —escrito como una descripción de puesto, no como una lista de deseos.

3. ¿Para qué sirve la base de conocimientos?

Respuesta: Para proporcionar al GPT documentos de referencia que consulta para responder —tus guías, catálogos o procedimientos—, en lugar de depender únicamente de su memoria de entrenamiento.

4. ¿Qué ocurre con las acciones de un GPT al migrar a un complemento?

Respuesta: No se transfieren: debes comprobar si ya existe una aplicación en el directorio de complementos; de lo contrario, reconstruye la integración, por ejemplo con un servidor MCP. Las instrucciones se convierten en una habilidad y la base de conocimientos en archivos de referencia.

5. Antes de compartir un GPT o un complemento, ¿qué compruebas?

Respuesta: Pruebas en casos reales y casos límite, cumplimiento de las políticas de uso, claridad de la descripción, una política de privacidad para cualquier acción pública y que no haya datos sensibles ocultos en las instrucciones o archivos.

Una herramienta compartida compromete a su creador: prueba como si tus usuarios ya estuvieran allí y migra tus GPTs antes del 11 de diciembre de 2026.