Смотреть урок

Если вы регулярно объясняете Codex одно и то же — что проверить, в каком порядке работать, какие правила соблюдать и каким должен быть результат — это можно вынести в отдельный Skill и больше не повторять каждый раз.

Что внутри:
🔹 что такое Codex Skills и когда они действительно нужны
🔹 как создать первый Skill и правильно оформить SKILL.md
🔹 как Codex выбирает нужный Skill и как проверить, что он работает
🔹 зачем нужны Skills API, версии, скрипты и границы действий

💡 Skill не обучает модель заново. Он сохраняет повторяемый рабочий процесс и позволяет запускать его коротким запросом вместо длинного промпта.

Codex Skills для новичка: как научить ИИ-агента новым рабочим сценариям

Если мы регулярно даём Codex похожие задачи, часть инструкций приходится повторять: что проверить, в каком порядке работать, какие правила соблюдать и каким должен быть результат.

Codex Skill позволяет сохранить такой рабочий сценарий отдельно и использовать его снова. Это не дообучение модели: мы не меняем сам ИИ, а даём агенту готовую инструкцию для определённого типа задач.

В документации OpenAl уже используются такие навыки. Например, для работы с официальной документацией и миграции проекта можно вызвать готовый Skill openai-docs вместо того, чтобы каждый раз подробно описывать весь процесс.

1. Что такое Codex Skill

Skill это отдельный набор инструкций для повторяемой задачи.
Например, мы регулярно просим Codex:

1. проверить изменённые файлы;
2. найти ошибки;
3. запустить тесты;
4. ничего не исправлять без запроса;
5. вернуть проблемы в определённом формате.

Вместо того чтобы каждый раз писать все эти правила заново, их можно сохранить в Skill.

Минимально Skill содержит файл: SKILL.md
В нём указываются название навыка, его назначение и инструкции для Codex.

У Skill также могут быть дополнительные материалы:

• scripts - скрипты, которые Skill может использовать;
• references - документация и справочные материалы;
• assets - шаблоны и другие необходимые файлы.

Для первого Skill всё это обычно не требуется: можно начать только с SKILL.md.
OpenAl рекомендует не перегружать инструкции и не добавлять инструменты или примеры без необходимости. Каждое правило лучше формулировать один раз и оставлять только то, что действительно влияет на результат.

2. Когда нужен Skill, а когда достаточно промпта

Skill полезен не для любой задачи. Он имеет смысл, когда один и тот же процесс повторяется.

Например:

• проверка проекта перед релизом;
• регулярный анализ кода;
• обновление документации;
• обработка…