Codex Skill хранит повторяемый workflow, инструкции и ресурсы. До установки чужого навыка нужно проверить все файлы и требуемые инструменты.

Skill — повторяемый workflow в виде SKILL.md, инструкций и дополнительных ресурсов. Codex может выбрать его по description или пользователь может вызвать навык явно через $ либо список skills в поддерживаемой поверхности.

Где хранить

Официальная документация описывает несколько scope:

  • repository — навык версионируется вместе с проектом;
  • user — доступен пользователю в разных проектах;
  • admin/system — управляется организацией или поставляется продуктом.

Для командного процесса выбирайте repository scope. Для личного универсального чеклиста — user scope.

Минимальный Skill

.agents/skills/release-check/
└── SKILL.md

---
name: release-check
description: Проверяет релиз-кандидат перед публикацией.
---

Проверь diff, тесты, миграции, секреты и rollback.
Верни решение: ready, needs fixes или blocked.
Ничего не публикуй без явного подтверждения.

Description должен ясно объяснять, когда навык применять и когда не применять. Слишком широкое описание вызывает ложные срабатывания.

Как проверить готовый Skill

  • прочитайте SKILL.md полностью;
  • найдите scripts и команды shell;
  • проверьте зависимости и MCP;
  • убедитесь, что нет чтения .env и внешней отправки данных;
  • оцените, какие записи или сообщения он может создавать;
  • протестируйте в временной папке.

Наличие навыка в репозитории не означает, что он безопасен или поддерживается OpenAI.

Skill и plugin

Skill — отдельный процесс. Plugin — устанавливаемый пакет, который может объединять несколько skills, connectors/MCP и настройки распространения. Для локального эксперимента достаточно skill; plugin полезен для доставки команде.

Хороший тест

Дайте три запроса: точный trigger, похожий negative case и неполный вход. Навык должен правильно сработать, не сработать и запросить недостающие данные. Затем сравните результат с ручным checklist.

Итог

Ценность Codex Skills не в количестве установленных файлов, а в стабильности процесса. Начните с одного workflow, версионируйте изменения и подключайте внешние инструменты только при понятной необходимости. Центр материалов: Skills.