improve-skill — скилл для Codex: что делает и как установить
Превращает результаты проверки plugin-eval в план доработки скилла для Codex. Пригодится, когда нужно сократить расход токенов и исправить ошибки в манифесте.
npx skills add openai/plugins --skill improve-skill -a codexЧто делает improve-skill
Скилл помогает отредактировать локальный скилл после тестирования в утилите plugin-eval. Сначала запускается анализ командой plugin-eval analyze <skill-path> --brief-out <brief.json>. Скилл разбирает полученный бриф и делит исправления на обязательные и рекомендованные.
В работе учитываются правила из руководства skill-creator. Главная задача — сделать файл SKILL.md компактнее, убрать объёмные детали в скрипты или справочные файлы и улучшить описания триггеров. Также скилл находит битые ссылки и проблемы во frontmatter.
Без предварительного прогона через plugin-eval скиллу не на чем строить бриф. После правок результаты до и после сравниваются командой plugin-eval compare before.json after.json.
Какие задачи решает
- составить план доработки скилла по отчёту plugin-eval
- сократить расход токенов на вызов и триггеры
- разгрузить SKILL.md переносом деталей в отдельные скрипты
- исправить ошибки в манифесте и frontmatter
- сравнить показатели скилла до и после правок
Примеры запросов агенту
- Улучши этот скилл на основе отчёта plugin-eval.
- Что мне исправить в этом скилле в первую очередь?
- Перепиши SKILL.md по результатам проверки и вынеси лишнее в референсы.
Как установить improve-skill
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill improve-skill -a codex2Вручную: положить файлы
.agents/skills/improve-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openai/plugins --skill improve-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/improve-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/improve-skill/
Вручную: положить файлы
.cursor/skills/improve-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openai/plugins improve-skill2Вручную: положить файлы
.github/skills/improve-skill/SKILL.mdКомандой платформы
gemini skills install https://github.com/openai/plugins --path plugins/plugin-eval/skills/improve-skillВручную: положить файлы
.devin/skills/improve-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Скиллы Codex: как установить, где лежат и как вызвать
Вопросы о improve-skill
Как установить improve-skill в Codex?
Выполните в терминале команду npx skills add openai/plugins --skill improve-skill.
Что делает improve-skill?
Он считывает результаты анализа plugin-eval, формирует план правок и оптимизирует SKILL.md. Это помогает уменьшить объём контекста и устранить ошибки в манифесте.
Что требуется для запуска improve-skill?
Нужна предварительно проведённая оценка через plugin-eval с готовым файлом брифа. Также скилл использует правила создания скиллов из руководства skill-creator.
Исходный текст
SKILL.md · MIT
--- name: improve-skill description: Turn plugin-eval findings into a concrete rewrite brief for a Codex skill. Use when the user already evaluated a skill and now wants Codex to improve it, especially after asking what to fix first. --- # Improve Skill Use this skill after `plugin-eval` has already produced findings for a local skill. ## Workflow 1. Run `plugin-eval analyze <skill-path> --brief-out <brief.json>`. 2. Read the improvement brief and group work into required fixes versus recommended fixes. 3. Apply the `skill-creator` guidance from `/Users/benlesh/.codex/skills/skill-creator/SKILL.md`. 4. Re-run the evaluation and compare before and after outputs. ## Chat Requests To Recognize - `Improve this skill based on the evaluation.` - `Rewrite this skill using the plugin-eval findings.` - `What should I fix first in this skill?` ## Focus Areas - reduce trigger and invoke token costs - keep `SKILL.md` compact - move bulky details into references or scripts - improve trigger descriptions - fix broken links and manifest/frontmatter issues ## Commands ```bash plugin-eval analyze <skill-path> --brief-out ./skill-brief.json plugin-eval compare before.json after.json ``` ## Reference - `../../references/chat-first-workflows.md`
© OpenAI Codex · MIT · openai/plugins
