Skill нужен
- одинаковая работа повторилась несколько раз;
- есть понятный вход и понятный результат;
- важно всегда соблюдать один порядок;
- есть проверка, которая показывает успех.
Шаг 3
Skill - это сохраненный порядок одной повторяющейся работы. Codex получает понятные шаги, перестает каждый раз изобретать процесс заново и тратит меньше времени на повторные объяснения.
Важное уточнение: в актуальном Codex официальный Skill Creator уже встроен OpenAI. Обычно его не нужно скачивать отдельно. Сначала вызови $skill-creator.
Сначала проверка
Не ставь вторую копию, если официальный системный skill уже доступен.
Проверь, доступен ли в этом 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-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. Отдельно скажи, что не проверялось.
Простой порядок
Не пытайся создать библиотеку заранее. Каждый новый skill должен появляться из реальной повторяющейся работы.
Финал всей настройки
Открой новый чат 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 без отдельного разрешения.