OpenAI logo

Skill

improve-skill

improve Codex skills from evaluation findings

Published by OpenAI Updated Apr 17
Covers Productivity Evals Codex Engineering

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.

SKILL.md

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

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

Reference

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

© 2026 YourAI.tools. Every skill from an identity-verified publisher.

Independent catalog. Not affiliated with, endorsed by, or sponsored by Anthropic or any listed publisher. All trademarks belong to their respective owners.