improve-skill

✓ Official★ 4,081

by openai · part of openai/plugins

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.

🧩 One of 7 skills in the openai/plugins package — works on its own, and pairs well with its siblings.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

Improve Skill

Use this skill after plugin-eval has already produced findings for a local skill.

Workflow

Run plugin-eval analyze <skill-path> --brief-out <brief.json>.
Read the improvement brief and group work into required fixes versus recommended fixes.
Apply the skill-creator guidance from /Users/benlesh/.codex/skills/skill-creator/SKILL.md.
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

plugin-eval analyze <skill-path> --brief-out ./skill-brief.json
plugin-eval compare before.json after.json

Reference

../../references/chat-first-workflows.md