improve-skill

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.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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

Repository: openai/plugins
Path: plugins/plugin-eval/skills/improve-skill/SKILL.md
Commit: 11c74d6

Last updated: 17 days ago
First committed: 4 months ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.