Codex CLI 0.166.0 se publicó el 29 de octubre de 2026. Si revisas tus skills locales a raíz de esa versión, valida primero la cabecera antes de reescribir el proceso. Las reglas siguientes pertenecen a la especificación actual de Agent Skills; no se atribuye un cambio de esas reglas a la versión de CLI.
Una carpeta con instrucciones no es automáticamente una skill válida. La especificación Agent Skills exige SKILL.md con cabecera YAML y después Markdown. Un error de formato puede impedir que el programa reconozca el procedimiento.
Revisa primero la cabecera
Para una carpeta weekly-brief, incluye name: weekly-brief y una descripción no vacía que explique tarea y uso. El nombre debe coincidir con la carpeta y cumplir las reglas de la especificación. Deja los separadores de la cabecera en líneas propias.
Pide revisar el texto antes de cambiar el proceso. Busca campos ausentes, sangría accidental o un nombre heredado de otro ejemplo. Usa la validación o actualización documentada: encontrar el archivo en el disco no demuestra que se haya reconocido.
Comprueba el reconocimiento sin datos privados
Actualiza la lista y revisa descripción y ruta. Si falla, guarda el mensaje de validación y corrige solo la causa identificada. No ejecutes la skill sobre documentos privados para probar su instalación. Validar metadatos y evaluar después el resultado son pasos distintos.
Estas comprobaciones se refieren a skills locales en Codex CLI y otros programas que implementan el estándar. La distribución por plugins y el acceso de la cuenta son cuestiones aparte. Codex detecta cambios automáticamente; si no aparecen, la guía recomienda reiniciarlo. No cambies permisos para corregir YAML.