Попросите Codex сократить описания навыков

Когда создаёте навык для Codex, попросите сделать его описание коротким. В поле описания (description) сразу укажите, что навык делает и когда его нужно применять. Подробные шаги оставьте в основном тексте SKILL.md.

Это связано с тем, как Codex выбирает навыки. Сначала он видит их названия и описания, а полную инструкцию читает, когда решает воспользоваться конкретным навыком. Документация OpenAI прямо рекомендует ставить главный сценарий и ключевые слова в начало: при большом наборе навыков описания могут сокращаться.

Например: «Проверяет договор перед подписанием: находит спорные условия и готовит вопросы юристу». Порядок проверки, формат ответа и ограничения можно подробно расписать внутри. При сокращении описания сохраните слова, по которым агент поймёт, для какой задачи нужен навык.

Для уже собранной библиотеки есть Skill Cleaner из репозитория Питера Штайнбергера: он помогает находить длинные описания и дубли. Начать можно и с обычного запроса к Codex.

Промпт:

Проверь описания моих навыков. Найди слишком длинные и похожие по смыслу. Предложи короткие варианты: сначала что навык делает и когда его применять. Сохрани ключевые слова и границы применения, подробные шаги предложи перенести в тело SKILL.md. Покажи варианты «было / стало». Пока ничего не меняй.

Следующий шаг

Skills и Plugins в Codex App: установка, использование и создание своих

Связанные материалы

Статья: Мои Codex skills: как мы собираем дисциплину для ИИ-агента

Блог: Skill Doctor проверяет скиллы по реальным сессиям

База знаний: Файлы контекста для ИИ-агентов: AGENTS.md, SKILL.md, DESIGN.md

Если собираете библиотеку навыков для команды, можно обсудить, как сделать их понятными агенту и удобными в работе.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov