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.

Jump to install Review files

Repository: openai/plugins
Last source activity: April 21, 2026 at 18:07
Detected SKILL.md language: English
Stars: 7,904
Forks: 1,014

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install only the Agent Skill at https://github.com/openai/plugins/tree/main/plugins/plugin-eval/skills/improve-skill.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/openai/plugins --skill improve-skill

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

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`

View on GitHub

Back to search Back to installation

openai-platform-api-key

Use when Codex is asked to build, run, test, debug, or configure an OpenAI-backed or provider-unspecified AI app, UI, script, CLI, generator, or tool, especially requests phrased only as "using AI" or generators driven by forms/user input; also use for OPENAI_API_KEY or sk-proj setup. Do not gate model or prompt migrations that can proceed with source edits and offline validation. Otherwise treat this as the credential gate: inspect safely, ask reuse-vs-new before API work, and never expose plaintext.

2026-11-03

assess-patch-risk

Assess an immutable patch artifact's program impact, regression risk, and auto-merge eligibility. Use for generated patch files, provider pull-request diffs, or commit ranges when reviewers need evidence about affected runtime paths, contracts, tests, and recoverability. This skill is read-only and does not generate, edit, apply, push, or merge the patch.

2026-10-08

attack-path-analysis

Use when Codex is already in the attack-path-analysis phase of a security scan or the user explicitly asks to trace a security finding from source to sink and calibrate severity. Do not use as the primary trigger for full PR, commit, branch, patch, or repository scans.

2026-10-08

View all from this repository

improve-skill

Source facts

Install options

Install with an AI assistant

Review the source files

More from this repository

Install with an AI assistant

More from this repository