Por qué se retiran los prompts personalizados
La página de OpenAI sobre el formato antiguo comienza con el veredicto: "Custom prompts are deprecated. Use skills for reusable instructions that Codex can invoke explicitly or implicitly."
La misma página explica la limitación que hizo necesario el cambio. "Custom prompts require explicit invocation and live in your local Codex home directory (for example, ~/.codex), so they're not shared through your repository. If you want to share a prompt (or want Codex to implicitly invoke it), use skills."
Esa frase lo dice todo. Un prompt personalizado es personal por diseño. Vive en ~/.codex/prompts, se invoca escribiendo su nombre, y un colega que clone el mismo repositorio no obtiene nada de él. Cualquier conocimiento de proceso que codificara era, en la práctica, de una sola persona.
Las skills están diseñadas para lo contrario. OpenAI describe una skill como algo que "packages instructions, resources, and optional scripts so either product can follow a workflow reliably", y Codex las lee desde varios lugares. Para los repositorios, "Codex scans .agents/skills in every directory from your current working directory up to the repository root". También existen ubicaciones de usuario, administrador y sistema, pero la ubicación del repositorio es la que hace que una skill sea compartida.
Toma nota del nombre de la carpeta. Es .agents/skills, no una carpeta dentro de .codex. La ubicación a nivel de usuario sigue el mismo patrón: $HOME/.agents/skills. Quienes buscan una carpeta de skills de Codex dentro de su directorio de inicio de Codex están buscando en el lugar equivocado.
Las skills también funcionan más allá de Codex CLI. "Standalone skills are available in the ChatGPT desktop app, Codex CLI, and IDE extension". Esa versatilidad es parte de la razón por la cual el formato antiguo se está retirando en lugar de mantenerse.
Qué intenta la gente en su lugar
Dejar los prompts donde están. Siguen funcionando por ahora, pero la obsolescencia significa que no recibirán nuevos comportamientos y seguirán siendo invisibles para cualquier otra persona del equipo.
Pegar cada prompt en un SKILL.md sin cambios. El resultado parece correcto pero se comporta de manera diferente. Un prompt solo se ejecutaba cuando escribías su nombre. Una skill se puede elegir automáticamente: Codex puede activar una mediante "invocación implícita", eligiendo una skill "cuando tu tarea coincida con la description de la skill". Una rutina de despliegue que solía esperar por ti ahora puede ofrecerse por sí sola.
Mantener los marcadores de posición y esperar que sigan expandiéndose. Los prompts personalizados admiten marcadores de posición posicionales, numerados del uno al nueve, que "se expanden a partir de los argumentos separados por espacios que proporcionas después del comando", además de $ARGUMENTS y marcadores de posición con nombre como $FILE. La documentación de las skills no describe una expansión de marcadores de posición equivalente. La guía de importación de OpenAI señala exactamente esta categoría para revisión: "Plantillas de prompts o prompts de estilo comando que dependen de argumentos, interpolación de shell o marcadores de posición de rutas de archivos".
Colocar cada skill en la raíz del repositorio. Codex ofrece una jerarquía por una razón. Una skill relevante para un servicio puede residir en el directorio de ese servicio; una skill a nivel de raíz es visible desde cada subcarpeta.
Confiar en que un importador lo haga. El flujo de importación de OpenAI mapea los "comandos de barra diagonal" a "skills" al transferir la configuración desde otros agentes, lo que cubre los comandos de otras herramientas. Es un punto de partida, no una revisión completa.
La solución: Convierte cada prompt deliberadamente y luego decide cómo se invocará
El objetivo es tener un conjunto de skills que hagan lo que hacían tus prompts, que residan donde tu equipo pueda verlas y que se activen solo cuando tú quieras.
Paso 1: Haz un inventario de tus prompts y clasifícalos según quién deba tenerlos
Abre ~/.codex/prompts y enumera cada archivo. Para cada uno, anota tres cosas: qué hace, si acepta argumentos y si es un proceso personal o de equipo.
Los prompts personales (tu estilo preferido de mensaje de confirmación, un hábito propio) pertenecen al nivel de usuario, en $HOME/.agents/skills. El uso sugerido por OpenAI para esa ubicación es "to curate skills relevant to a user that apply to any repository the user may work in".
El proceso de equipo (cómo el repositorio publica lanzamientos, cómo se realizan las revisiones) pertenece al repositorio. Si se aplica a todo el repositorio, usa la raíz; OpenAI describe las skills de raíz como "available to any subfolder in the repository". Si se aplica a un área específica, colócala más cerca: una skill a nivel de carpeta es adecuada para "skills only relevant to a microservice or a module".
Mientras haces la lista, verifica si alguno de tus prompts duplica el propósito de otro. Codex no concilia duplicados: "If two skills share the same name, Codex doesn't merge them; both can appear in skill selectors". Dos skills casi idénticas con el mismo nombre aparecerán juntas, lo cual resulta confuso para ti y para tus compañeros de equipo.
Paso 2: Reescribe cada prompt como una skill, reemplazando los marcadores de posición con entradas explícitas
Una skill es una carpeta con un archivo SKILL.md, y "The SKILL.md file must include name and description". Crea una carpeta por cada prompt.
La descripción es la línea más importante que escribirás, porque es la forma en que Codex decide si se aplica una skill. La guía de OpenAI: "write concise descriptions with clear scope and boundaries. Front-load the key use case and trigger words so a host can still match the skill if descriptions are shortened". La plantilla del creador lo expresa aún más claramente: "Explain exactly when this skill should and should not trigger".
Para los prompts que aceptaban argumentos, convierte cada marcador de posición en una entrada explícita que soliciten las instrucciones. Donde el prompt le decía a Codex "stage them first: $FILES", la skill indica qué archivos preparar y cómo averiguarlo si no se especificaron. Las mejores prácticas de OpenAI para las skills apuntan en la misma dirección: "Write imperative steps with explicit inputs and outputs".
Mantén cada skill enfocada en una sola tarea (OpenAI enumera "Keep each skill focused on one job" como la primera de sus mejores prácticas) y prefiere las instrucciones sobre los scripts "unless you need deterministic behavior or external tooling".
Si un prompt es más fácil de mostrar que de describir, OpenAI documenta otras dos vías: el creador integrado, invocado en Codex como $skill-creator, que "asks what the skill does, when it should trigger, and whether it should stay instruction-only or include scripts", y Record & Replay, que genera un borrador de skill a partir de una demostración.
Paso 3: Decide la invocación, deshabilita los duplicados y luego prueba los activadores
Para cada skill convertida, decide si alguna vez debería ejecutarse por sí sola. Cualquier cosa con efectos secundarios (desplegar, abrir solicitudes de extracción, eliminar ramas) es candidata para mantenerse como explícita.
OpenAI documenta el interruptor para esto en un archivo opcional agents/openai.yaml dentro de la skill: allow_implicit_invocation tiene el valor predeterminado de true, y "When false, Codex won't implicitly invoke the skill based on user prompt; explicit $skill invocation still works". Eso restaura el comportamiento del antiguo prompt para las skills que lo necesitan.
Para retirar una skill sin eliminarla, OpenAI documenta las entradas [[skills.config]] en ~/.codex/config.toml con enabled = false, seguido de un reinicio.
Luego realiza pruebas. El consejo de OpenAI es "Test prompts against the skill description to confirm the right trigger behavior". Dale a Codex algunas tareas que deberían activar cada skill y algunas que no, y ajusta las descripciones hasta que los resultados coincidan con tu intención. Codex "detects skill changes automatically" y sugiere un reinicio si una actualización no aparece.
Finalmente, una vez que las skills se comporten como deseas, elimina los archivos de prompts antiguos para que solo quede una versión de cada rutina.
Configuración en MemoryLake
Una skill convertida captura cómo hacer una tarea. No captura por qué la tarea se hace de esa manera: el incidente que llevó a la lista de verificación de lanzamiento, la razón por la cual las revisiones verifican primero las migraciones. MemoryLake es un lugar para guardar esas razones, de modo que el procedimiento y su justificación no se distancien.
Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni elimina nada de tu carpeta de inicio de Codex, de los directorios de skills de tu repositorio ni del almacenamiento de ningún proveedor.
Paso 1: Crea una clave API
Inicia sesión y genera una clave desde el panel de control. La clave es lo que permite a un agente leer las entradas que has escrito, ya sea en Codex o en cualquier otra herramienta que use tu equipo.
Paso 2: Sube tus primeras memorias
Para cada skill de equipo, añade la decisión detrás de ella: por qué existe el paso, qué salió mal sin él y quién estuvo de acuerdo. Una decisión por entrada, con la razón adjunta.
Paso 3: Conecta tu IA y agentes
Apunta tus agentes al espacio de trabajo. Las razones estarán disponibles dondequiera que se realice el trabajo, incluso en herramientas que no leen .agents/skills en absoluto.
Qué cambia esto en la práctica
La primera diferencia es que el conocimiento del proceso se convierte en conocimiento del equipo. Un prompt en la carpeta de inicio de una persona se iba con esa persona. Una skill en el repositorio es revisada, versionada y está disponible para todos, lo cual es el mismo paso que hace que lograr que Codex siga las reglas de AGENTS.md de manera consistente sea una preocupación del equipo en lugar de una personal.
La segunda es que la invocación se convierte en una decisión. Los prompts siempre eran explícitos. Las skills, por defecto, son elegibles para uso automático. Tomar esa decisión por cada skill requiere poco trabajo y evita grandes sorpresas.
La tercera es que la distinción entre reglas y procedimientos se vuelve más clara. Los hechos del proyecto que siempre son ciertos pertenecen a los archivos de instrucciones; los procedimientos de tareas pertenecen a las skills. Esta misma división se analiza para Cursor en cuándo usar skills frente a reglas, y se aplica por igual aquí. Mezclar ambas cosas es una de las razones por las que Codex olvida el contexto del proyecto en primer lugar.
La cuarta es la portabilidad. Las skills siguen un estándar abierto, razón por la cual la misma carpeta puede tener sentido en más de una herramienta; el patrón detrás de mover memorias de Devin a skills y detrás de que las skills aparezcan en catálogos inesperados, como en el catálogo de skills de Zed.
Mejores prácticas para convertir prompts en skills
Busca en .agents/skills, no en .codex. Las skills del repositorio residen en directorios .agents/skills; las de usuario, en $HOME/.agents/skills.
Separa lo personal de lo de equipo antes de convertir. El lugar donde reside una skill determina quién tiene acceso a ella.
Escribe la descripción como una condición de activación. Indica cuándo debe y cuándo no debe aplicarse, y coloca las palabras clave al principio.
Reemplaza los marcadores de posición con entradas explícitas. La documentación de las skills no describe la expansión de argumentos, y la guía de importación de OpenAI señala los prompts que dependen de marcadores de posición para su revisión.
Desactiva la invocación implícita para cualquier cosa con efectos secundarios. Establece allow_implicit_invocation en false y mantén esas skills como explícitas.
Asigna a cada skill un nombre único. Codex muestra las skills con el mismo nombre una al lado de la otra en lugar de fusionarlas.
Guarda la justificación en un lugar duradero. Las skills son procedimientos, no memoria; lo que significan las skills de Grok para la memoria de IA hace la misma distinción para otro proveedor, y migrar reglas de Cursor a Codex cubre la tarea adyacente de mover instrucciones que siempre están activas.
Conclusión
La nota de obsolescencia de OpenAI consta de dos frases, y la segunda lo explica todo: los prompts personalizados "live in your local Codex home directory", por lo que "they're not shared through your repository". Las skills solucionan eso. Residen en .agents/skills, se pueden limitar a una carpeta o a todo el repositorio, y funcionan en Codex CLI, la extensión de IDE y la aplicación de escritorio de ChatGPT.
La conversión es donde se necesita cuidado. Las skills pueden activarse por sí solas a menos que indiques lo contrario, y los marcadores de posición de los que dependían tus prompts deben convertirse en entradas explícitas.
Haz un inventario de los prompts, clasifícalos según quién deba tenerlos, reescribe cada uno con una descripción precisa, define la invocación deliberadamente y prueba los activadores. Luego, elimina los archivos antiguos y guarda las razones detrás de cada rutina en un lugar donde el próximo compañero de equipo pueda leerlas.