Создайте навык в каталоге проекта
В тестовом репозитории создайте .agents/skills/release-note/SKILL.md. Сначала достаточно одного файла, где указаны имя, описание задачи и последовательность шагов. Имя папки и идентификатор удобно держать одинаковыми. В описание внесите фразы, которые использует человек, например «заметка о выпуске» и «что изменилось для читателя». Если инструкции нужны только одному репозиторию, храните их там и проверяйте из его рабочей папки.
---
name: release-note
description: Готовит короткую заметку о выпуске сайта по списку изменений.
---
Прочитай список изменений из задачи.
Раздели результат на «Что увидит читатель» и «Как проверено».
Не придумывай результаты проверок. Отметь, чего ещё не проверили.Не добавляйте в первую версию команды выкладки. Попросите обработать два входных факта: «в карточке появилась обложка» и «ширина проверена на 390 px». Ожидаемый результат состоит из двух отдельных частей. В первой указана обложка, во второй указан только замер ширины. Если факт о кнопке подписки отсутствует, его нельзя добавлять как выполненную проверку.
Сначала вызовите явно, затем проверьте обычный запрос
Запустите свежую сессию Codex из корня проекта и найдите release-note среди навыков. В CLI можно выбрать его явным вызовом через меню навыков или вводом имени через знак доллара. Передайте те же два факта и проверьте, соблюдена ли структура. Затем откройте отдельную сессию и попросите написать заметку о выпуске обычными словами. Сохраните формулировку, по которой инструмент нашёл или пропустил навык.
Если ручной вызов работает, а обычный запрос не подхватывает навык, уточните описание. Например, фраза «подготовить заметку для сайта из готового списка правок» помогает отделить эту задачу от полного плана релиза. Попробуйте ещё один запрос с другой формулировкой. Изменяйте по одному элементу, чтобы понять, на что отреагировал инструмент.
Разберите отсутствие навыка или слабый результат
Если навык вообще не отображается, проверьте текущую папку, имя SKILL.md и блок YAML в начале. В редакторе убедитесь, что файл действительно сохранён. Откройте новый сеанс после исправления и повторите явный вызов. Если навык виден, но результат нарушает правила, сократите шаги и добавьте точный критерий приёмки. Для заметки это два названных раздела и опора только на входные факты.
Когда пример стабильно воспроизводится, добавьте один тест с пропущенным фактом о проверке. Ожидаемая заметка должна прямо указать, что подтверждения пока нет. Такая проверка полезнее оценки текста по общему впечатлению. Если позже подключите скрипт или справочник, проверьте путь из отдельного клона, чтобы навык не зависел от папок конкретного компьютера.
Официальная документация: шаги и условия работы инструмента.