Навыки Codex: как передать агенту рабочий метод, а не просто просьбу
Обычная ошибка с Codex выглядит безобидно: каждый раз просить его “сделай статью”, “проверь источники”, “подготовь письмо”, “нарисуй обложку”. Один раз это работает. На десятый раз редакция уже спорит не о качестве, а о том, почему один и тот же процесс каждый раз начинается заново.
В официальной документации OpenAI этот слой называется Agent Skills: навык упаковывает инструкции, ресурсы и при необходимости скрипты так, чтобы Codex мог надежно повторять рабочий процесс. Для журнала, проекта или небольшой команды это важнее, чем кажется. Навык превращает просьбу в маленький производственный метод.
Почему промпта уже мало
Промпт хорош, когда задача разовая. Например: “собери тезисы по этой странице документации”. Но если задача повторяется, промпт быстро становится устной традицией. Сегодня вы помните, что в статье нужен источник, проверка, визуальный бриф и человеческое решение. Завтра кто-то попросит короче, быстрее, без источников, и система снова начнет плавать.
Навык нужен там, где есть повторяемый контур:
- вход: какие файлы, ссылки, заметки или ограничения дает человек;
- процесс: какие шаги Codex обязан пройти;
- выход: какой артефакт должен появиться;
- проверка: как человек без программирования понимает, что результат годится;
- граница: какое решение Codex не принимает сам.
Это очень похоже на регламент, только написанный не для папки “процессы”, а для реального агента, который будет выполнять работу.
Что официально говорит документация
Документация Codex описывает skill как директорию с обязательным SKILL.md и возможными дополнительными материалами: скриптами, references, assets. Codex сначала видит короткий список доступных навыков: название, описание и путь. Полные инструкции он открывает только тогда, когда решает, что навык подходит задаче.
Это называется progressive disclosure: не тащить весь регламент в каждый запрос, а подгружать метод только в нужный момент. Для контент-завода это почти идеальная модель. У нас могут быть отдельные навыки для заголовков, структуры статьи, источников, визуала, публикации и социальной карточки. Codex не обязан каждый раз держать все в голове. Он выбирает нужный инструмент.
Важная деталь: документация советует держать skill сфокусированным на одной работе. Это прямой ответ на соблазн сделать один огромный “навык редакции”, который умеет все. Такой монолит быстро становится тем же хаосом, только в Markdown-файле.
Что дать Codex на вход
Для рабочего навыка не надо начинать с идеального кода. Достаточно карточки задачи. Например, если мы хотим навык заголовков для журнала, вход может быть таким:
| Что передаем | Зачем это нужно |
|---|---|
| Тема статьи | Чтобы title не ушел в абстрактный “про Codex” |
| Официальный источник | Чтобы заголовок не обещал больше, чем доказано |
| Аудитория | Чтобы писать для владельца процесса, а не только для разработчика |
| Главная боль читателя | Чтобы H1 начинался с понятной рабочей ситуации |
| Запрещенные формулировки | Чтобы не получать кальку вроде “in-app browser” в начале русской статьи |
В таком виде Codex уже не “придумывает заголовок”. Он применяет метод: сначала человек и задача, потом продукт и официальный термин, потом SEO-обещание.
Какой артефакт должен вернуть навык
Хороший skill возвращает не поток рассуждений, а проверяемый артефакт. Для навыка заголовков это может быть не один вариант, а маленькая таблица:
| Поле | Что возвращает Codex | Как проверить |
|---|---|---|
| H1 | Русский заголовок статьи | Понятно ли без знания английского термина |
| SEO title | Более поисковая версия | Есть ли основной запрос и нет ли обмана |
| Meta description | Обещание статьи в 1-2 фразах | Ясно ли, что человек узнает |
| H2 map | 5-7 рабочих вопросов | Ведут ли они к решению, а не к пересказу документации |
| Risk note | Что нельзя обещать | Не выходит ли статья за пределы источника |
Для визуального навыка артефакт другой: concept packet, render prompt, source image, финальный GIF, media manifest и QA. Для навыка источников - source packet, duplicate check, public-source gate. Для навыка публикации - Ghost URL, live audit и статусы очередей.
Главная мысль одна: если навык не возвращает проверяемый результат, он не навык, а длинная просьба.
Как проверить это без программирования
Непрограммисту не нужно читать внутренности скриптов. Ему нужна простая приемка.
Для любого skill можно задать четыре вопроса:
- Понятно ли, когда этот навык должен включаться?
- Понятно ли, что человек дает Codex на вход?
- Понятно ли, какой файл, таблицу, карточку или пакет Codex должен вернуть?
- Понятно ли, где решение остается за человеком?
Если на один из вопросов нет ответа, навык пока сырой. Его нельзя вешать на автоматизацию, потому что он будет вести себя как устная договоренность.
Где здесь место контент-завода
Контент-завод не должен быть одним агентом, который “как-нибудь сделает статью”. Его лучше видеть как редакционную цепочку навыков.
Сначала source-intake skill проверяет источник. Потом title skill формирует H1, SEO title и H2-карту. Затем article-writing skill пишет текст. После этого visual-production skill делает обложку. Publisher skill публикует только готовый пакет. ArticleFactory ставит социальные посты в очередь и хранит статусы.
Это не бюрократия. Это способ не терять качество, когда публикаций становится много. Мы уже отдельно писали, почему Codex полезен как рабочий кабинет проекта, а не просто чат. Навыки - следующий слой: в этом кабинете появляются не только файлы, но и повторяемые рабочие инструменты.
Минимальная карточка skill для редакции
Вот как может выглядеть самый маленький полезный бриф:
Название: onff-title-architect
Когда включать: когда нужна статья для журнала, SEO title, H1, H2-карта или meta description.
Вход: тема, официальный источник, аудитория, рабочая боль читателя, внутренние ограничения.
Выход: H1, meta title, meta description, slug, H2 map, риск обещаний.
Проверка: русский смысл первым, официальный термин только как уточнение, без завышения источника.
Человеческое решение: утверждать угол статьи и степень кликбейтности.Такой навык уже можно тестировать на реальных статьях. Если он стабильно улучшает заголовки, его можно закреплять. Если нет, лучше править маленький skill, чем весь контент-завод.
Что остается человеческим
Codex может предложить структуру, варианты заголовков, визуальный бриф и даже черновик. Но он не должен сам решать, какую редакционную ставку делает журнал. Человек выбирает, что важнее в конкретной статье: поиск, ясность, провокация, обучение, серия, внутренний контекст или публичная осторожность.
Навык не отменяет редактора. Он убирает повторяемую мутную работу вокруг редактора. И это как раз та точка, где Codex становится не “еще одним ИИ-чатом”, а производственным инструментом.
