Skip to main content
affpapa.org
RU EN
skill CX Codex GP ChatGPT official · OpenAI

improve-skill — Codex skill: what it does, how to install

Converts plugin-eval test reports into a concrete rewrite brief for Codex skills. Useful when you need to trim token costs and clean up frontmatter.

Install into Codex · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add openai/plugins --skill improve-skill -a codex
Open on GitHub

What improve-skill does

This skill restructures local Codex skills after testing them with the plugin-eval tool. It relies on output from plugin-eval analyze <skill-path> --brief-out <brief.json>. The skill splits findings into mandatory fixes and optional recommendations.

The process incorporates guidelines from skill-creator. It trims SKILL.md down, offloads large context blocks into external references or scripts, and refines trigger phrases. It also flags broken links and frontmatter issues.

Without a prior plugin-eval run, the skill has no findings to act on. After editing, verify changes with plugin-eval compare before.json after.json.

What it helps with

  • turn plugin-eval test outputs into a structured rewrite brief
  • reduce trigger and invoke token overhead
  • offload heavy context from SKILL.md into reference docs
  • fix broken links and frontmatter mistakes
  • compare evaluation scores before and after refactoring

Example prompts for the agent

  • Improve this skill based on the evaluation.
  • What should I fix first in this skill?
  • Rewrite this skill using the plugin-eval findings.

How to install improve-skill

1Skills CLI (Vercel)

npx skills add openai/plugins --skill improve-skill -a codex

2Manually: put the files in place

.agents/skills/improve-skill/SKILL.md

For all projects use ~/.agents/skills/

Step by step, with commands for each platform: Codex skills: how to install, where they live, how to call them

Questions about improve-skill

How to install improve-skill in Codex?

Run npx skills add openai/plugins --skill improve-skill in your terminal.

What does improve-skill do?

It processes plugin-eval analysis data and creates a clear action plan for skill refactoring. It helps optimize prompt length, refine trigger wording, and cut token costs.

What is required before running improve-skill?

You need plugin-eval to generate an evaluation brief first. The workflow also references instructions from skill-creator to guide the rewrite.

Source text

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

Similar skills

All skills for Agent setup: memory, context, orchestration →
setup-matt-pocock-skills Matt Pocock This skill configures a repository for Matt Pocock's engineering skills by setting its issue tracker, triage labels, and domain docs layout. Run it before using the other skills. 1,052,851installs ask-matt Matt Pocock Routes you to the right Matt Pocock skill or flow for the task at hand. Use it when you need a starting point for a feature, prototype, incoming issue, or hard bug. 766,587installs to-tickets Matt Pocock Turns a plan, spec, or conversation into small end-to-end tickets with explicit blockers. Use it to agree on the work breakdown before tickets go to a tracker. 711,230installs writing-plans Jesse Vincent This skill turns requirements for a multi-step task into an implementation plan before code changes begin. It helps when another engineer needs exact files, interfaces, and checks. CX Codex 282,859installs caveman-review JuliusBrussee Turns code review comments into one line per finding: location, problem, fix. Useful when a diff or PR needs a fast pass without the filler. CX Codex +1 411,800installs caveman-compress JuliusBrussee Compresses CLAUDE.md, todo lists, and other prose files into a shorter format while retaining a readable backup. CX Codex +1 411,500installs

From the same set528

The whole set →
shopify-onboarding-dev Walks a developer from nothing to a working Shopify setup: installs the CLI, wires up the AI toolkit, then asks what you want to build. CX Codex GP ChatGPT 1installs shopify-functions A Codex and ChatGPT skill for building Shopify Functions backend logic, from discounts to cart validation. It searches the docs first and validates the code before handing it over. CX Codex GP ChatGPT 1installs shopify-custom-data A Claude and Claude skill that walks the agent through Metafields and Metaobjects in Shopify apps. CX Codex GP ChatGPT 1installs metric-pack-designer A skill that helps you describe a local metric pack for plugin-eval: rubric categories, checks and metrics in a schema-compatible shape. CX Codex GP ChatGPT 1installs evaluate-skill Audits a local skill, explains the score, and points to the first fixes. Use it before benchmarking or measuring token usage. CX Codex GP ChatGPT 1installs evaluate-plugin Walks through a local Claude plugin and tells you what to fix first. Useful before you compare versions. CX Codex GP ChatGPT 1installs dashboard-expert Inspects, updates, and creates Mixpanel dashboards using Python and the mixpanel_headless library in Codex. CX Codex GP ChatGPT 1installs narrator narrator creates voice audio for timed video segments or a continuous long-form story. Use it when consistent voice and checked pauses matter. CX Codex GP ChatGPT 1installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor