ИИ и информация

Файл скилла есть, но метаданные неверны: проверьте YAML

Сверьте обязательные поля SKILL.md и совпадение имени с названием папки.

Codex CLI 0.166.0 вышла 29 октября 2026 года. Если проверяете локальные скиллы после знакомства с этой версией, начните с заголовка файла, прежде чем переписывать процесс. Правила ниже взяты из действующей спецификации Agent Skills; их изменение не приписывается этому выпуску CLI.

Папка с инструкциями ещё не является корректным скиллом. Открытая спецификация Agent Skills требует SKILL.md с заголовком YAML и следующим за ним Markdown. Ошибка формата может помешать приложению распознать задуманную процедуру.

Сначала проверьте небольшой заголовок

Для папки weekly-brief минимальный заголовок содержит name: weekly-brief и непустое описание задачи и условий применения. Имя должно совпадать с папкой и соответствовать правилам спецификации. Начальный и конечный разделители заголовка ставятся на отдельные строки.

Поручите сначала проверить текст файла, а не переделывать процесс. Ищите пропущенные поля, случайные отступы и название от другого примера. Используйте документированный валидатор или обновление списка: наличие на диске не доказывает распознавание.

Подтвердите появление без частных документов

Обновите список скиллов, прочитайте описание и путь. Если ошибка осталась, сохраните сообщение и исправляйте установленную причину. Не запускайте скилл на личных документах ради проверки установки. Корректность метаданных и качество будущего результата — отдельные этапы.

Эта проверка относится к локальным скиллам Codex CLI и других приложений с поддержкой стандарта. Распространение через плагины и доступ аккаунта проверяются отдельно. Codex обнаруживает изменения автоматически; если правка не появилась, текущая инструкция рекомендует перезапустить Codex. Не меняйте разрешения ради исправления YAML.

Источники и подробности

  1. Agent Skills — current specification
  2. OpenAI — Build skills
  3. OpenAI — Codex CLI 0.166.0 release, 29 October 2026

Источники подтверждают технические объяснения. Примеры и предлагаемые проверки подготовлены для этой статьи.