Codex CLI 0.166.0 est sorti le 29 octobre 2026. Si vous vérifiez vos skills locales à cette occasion, validez d’abord l’en-tête avant de réécrire la procédure. Les règles ci-dessous viennent de la spécification actuelle Agent Skills ; elles ne sont pas présentées comme une modification de cette version de la CLI.
Un dossier d’instructions n’est pas automatiquement une skill valide. Le standard ouvert Agent Skills exige SKILL.md avec un en-tête YAML suivi de Markdown. Un défaut de format peut empêcher l’application de reconnaître la procédure.
Valider d’abord l’en-tête
Pour un dossier weekly-brief, le minimum comprend name: weekly-brief et une description non vide du travail et de son usage. Le nom doit correspondre au dossier et respecter les règles du standard. Placez chaque séparateur d’en-tête sur sa propre ligne.
Demandez une inspection du texte avant de réécrire le processus. Cherchez champ manquant, indentation accidentelle ou nom repris d’un exemple. Utilisez le validateur ou le rafraîchissement documenté : la présence sur disque ne prouve pas la reconnaissance.
Confirmer sans tâche privée
Actualisez la liste et examinez description et chemin. Si l’échec persiste, conservez le message de validation et corrigez seulement la cause identifiée. N’exécutez pas la skill sur des documents privés pour tester l’installation. Métadonnées et qualité du résultat constituent deux contrôles distincts.
Ces contrôles concernent les skills locales de Codex CLI et des applications compatibles avec le standard. Distribution par plugin et accès du compte restent distincts. Codex détecte les changements automatiquement ; sinon, le guide actuel recommande de redémarrer Codex. Ne modifiez pas les permissions pour corriger une erreur YAML.