Шаг 3

Теперь научись создавать свои skills

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

Официальный Skill Creator Один skill на одну работу В конце ручной тест
!

Важное уточнение: в актуальном Codex официальный Skill Creator уже встроен OpenAI. Обычно его не нужно скачивать отдельно. Сначала вызови $skill-creator.

Сначала проверка

Есть ли Skill Creator

Не ставь вторую копию, если официальный системный skill уже доступен.

Проверить официальный Skill Creator
Проверь, доступен ли в этом Codex официальный системный skill с названием skill-creator.

1. Сначала проверь только системный skill Codex по точному имени .system/skill-creator. Не просматривай весь список skills и не открывай одноименные копии из проекта или пользовательской папки.
2. Если системный skill доступен, прочитай только его заголовок и данные о происхождении, нужные для подтверждения. Не загружай весь SKILL.md без необходимости.
3. Если системный skill-creator доступен, ничего не устанавливай повторно.
4. Подтверди, что это системный skill OpenAI.
5. Покажи, как его вызвать командой $skill-creator.
6. Не меняй файлы проекта.

Если skill-creator отсутствует:
1. Объясни, что системные skills устанавливаются вместе с актуальной версией Codex.
2. Предложи обновить официальный Codex и перезапустить его.
3. После перезапуска проверь еще раз.
4. Не устанавливай случайную или вторую копию skill-creator в проект.
5. Если после обновления его все еще нет, остановись и помоги проверить версию и установку Codex.
6. Покажи официальный исходник только для сверки:
https://github.com/openai/skills/tree/main/skills/.system/skill-creator
7. Не меняй проект, не делай commit, push или deploy.

В конце скажи простыми словами:
- доступен ли skill-creator;
- встроен он или установлен отдельно;
- как его запустить.

Что такое свой skill

Когда его создавать

Создавай skill не для любой мысли, а для работы, которая реально повторяется.

Skill нужен

  • одинаковая работа повторилась несколько раз;
  • есть понятный вход и понятный результат;
  • важно всегда соблюдать один порядок;
  • есть проверка, которая показывает успех.

Skill не нужен

  • задача разовая;
  • еще непонятно, как правильно ее делать;
  • такой skill уже есть в Superpowers;
  • достаточно короткого обычного prompt.

Создание

Prompt для своего skill

Замени строку в квадратных скобках на реальную повторяющуюся работу.

Создать новый skill
$skill-creator

Помоги мне создать skill для повторяющейся работы:
[ОПИШИ ОДНУ ПОВТОРЯЮЩУЮСЯ РАБОТУ]

Говори простыми словами.
Не спрашивай о том, что я уже написал.
Если информации не хватает, задай не больше пяти вопросов.
Задавай только один короткий вопрос за раз.
Не начинай создавать файлы, пока не поймешь работу полностью.

Если это еще непонятно, выясни:
1. Как звучит моя обычная просьба и когда этот skill нужен или не нужен.
2. Что я передаю в начале работы.
3. Что должно получиться в конце и как проверить результат.
4. Какие шаги повторяются и какие ошибки нельзя допускать.
5. Какие действия требуют моего разрешения и нужны ли готовые scripts, справочные файлы или шаблоны.

Перед созданием:
1. Посмотри только названия и короткие описания skills этого проекта и доступных skills.
2. Не открывай все skills и не сканируй весь каталог. Не читай полный Superpowers.
3. Если найдешь похожий skill, открой только его и сравни задачи.
4. Если такая возможность уже есть, не создавай копию. Объясни, какой существующий skill использовать.
5. Если копии нет, предложи короткое понятное название и покажи будущий порядок работы.
6. Спроси мое подтверждение и остановись до моего ответа.

Если новый skill нужен:
1. Создай его для этого проекта в .agents/skills.
2. Используй init_skill.py из официального Skill Creator.
3. Используй отдельную папку с тем же названием, что у skill.
4. Сделай SKILL.md коротким и понятным.
5. В описании напиши, что делает skill и при каких просьбах его нужно включать.
6. Внутри skill отдельно напиши, когда его не нужно включать.
7. Создай agents/openai.yaml по правилам официального Skill Creator.
8. Не создавай README, changelog и другие лишние документы.
9. Добавляй scripts, references и assets только если без них нельзя нормально повторять работу.
10. Не читай и не сохраняй секреты.
11. Не выполняй внешние действия, оплату, публикацию, commit, push или deploy без моего отдельного разрешения.

После создания:
1. Запусти quick_validate.py из официального Skill Creator для созданной папки. Если ему не хватает PyYAML, запусти его через uv во временном окружении и не добавляй эту зависимость в проект.
2. Запусти каждый добавленный script на безопасном примере.
3. Проверь skill на одном запросе, где он должен сработать.
4. Проверь его на одном запросе, где он не должен сработать.
5. Исправь найденные проблемы.
6. Кратко покажи созданные файлы, правило включения skill и фактические результаты проверок. Не печатай длинные служебные журналы.
7. Отдельно скажи, что не проверялось.

Простой порядок

Как дальше делать новые skills

Не пытайся создать библиотеку заранее. Каждый новый skill должен появляться из реальной повторяющейся работы.

  1. Найди одну работу, которая повторяется.
  2. Собери хорошие и плохие примеры.
  3. Опиши шаги и ожидаемый результат.
  4. Укажи запреты и нужные разрешения.
  5. Создай skill через $skill-creator.
  6. Проверь его на настоящем примере.

Финал всей настройки

Ручной тест

Открой новый чат Codex в проекте. Перед копированием впиши точное название папки созданного skill. Этот тест проверит starter, Superpowers и именно этот skill вместе.

Общий ручной тест
Это ручной тест всей настройки проекта.

Название созданного skill:
[ВСТАВЬ ТОЧНОЕ НАЗВАНИЕ ПАПКИ SKILL]

Ничего не меняй, пока не выполнишь первую часть.

Часть 1. Проверка starter.
1. Прочитай правила проекта.
2. Скажи простыми словами, что это за проект.
3. Назови текущую главную задачу.
4. Назови только те файлы, которые тебе нужны для ее понимания.
5. Назови действия, которые требуют моего разрешения.

Часть 2. Проверка Superpowers.
1. Объясни, какой порядок разработки будет использован.
2. Не начинай писать код до понимания задачи и согласования плана.
3. Для новой функции сначала подготовь проверку.
4. Для ошибки сначала покажи, как ее повторить.
5. Перед словом "готово" запусти нужные тесты и проверь изменения.

Часть 3. Проверка моего skill.
1. Если вместо точного названия выше остался текст в квадратных скобках, остановись и попроси меня вписать название.
2. Подставь указанное выше название в путь .agents/skills/[ТОЧНОЕ НАЗВАНИЕ]/SKILL.md и найди только этот файл.
3. Если такого файла нет, остановись, покажи проверенный путь и попроси меня уточнить название.
4. Не просматривай все остальные skills и не выбирай skill по догадке.
5. Покажи, виден ли указанный мной skill.
6. Объясни, когда он должен использоваться.
7. Объясни, когда он не должен использоваться.
8. Пока не запускай его.

Часть 4. Маленькая настоящая задача.
После первых трех частей попроси меня дать одну маленькую реальную задачу.
Сначала повтори цель своими словами.
Затем скажи, как поймешь, что задача решена.
Покажи короткий план и дождись подтверждения.
После подтверждения выполни задачу по правилам Superpowers.
В конце покажи:
- какие файлы изменены;
- какие проверки запущены;
- их фактический результат;
- что не проверялось;
- какой следующий шаг.

Не удаляй и не перезаписывай файлы.
Не читай .env и секреты.
Не делай commit, push или deploy без отдельного разрешения.
Официальные источники: OpenAI Build Skills и системный Skill Creator OpenAI.