Prompt Improver
severity1/claude-code-prompt-improver
This skill enriches vague prompts with targeted research and clarification before execution.
Improve and rewrite user prompts to reduce ambiguity and improve LLM output quality.
Install Prompt Optimization
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install proflead/codex-skills-library prompt-optimization --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/prompt-optimization .claude/skills/prompt-optimization && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .claude/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimizationType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install proflead/codex-skills-library prompt-optimization --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.codex/skills/prompt-optimization .agents/skills/prompt-optimization && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .agents/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install proflead/codex-skills-library prompt-optimization --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.codex/skills/prompt-optimization .cursor/skills/prompt-optimization && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .cursor/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/proflead/codex-skills-library.git --path .codex/skills/prompt-optimization--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install proflead/codex-skills-library prompt-optimization --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.codex/skills/prompt-optimization .gemini/skills/prompt-optimization && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .gemini/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install proflead/codex-skills-library prompt-optimizationInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .github/skills && cp -r skills-src/.codex/skills/prompt-optimization .github/skills/prompt-optimization && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .github/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add proflead/codex-skills-library --skill prompt-optimization -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install proflead/codex-skills-library prompt-optimization --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/proflead/codex-skills-library.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.codex/skills/prompt-optimization .opencode/skills/prompt-optimization && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "prompt-optimization" agent skill from https://github.com/proflead/codex-skills-library/tree/master/.codex/skills/prompt-optimization into .opencode/skills/prompt-optimization/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-optimization", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
prompt-optimization- GitHub stars
- 155
- Token cost
- ~263 tokens
- SKILL.md length
- 105 words
- Files
- 1
- Skills in repo
- 10
- Repo updated
- First seen
- Licence
- None found
At a glance
Improve and rewrite user prompts to reduce ambiguity and improve LLM output quality.
- Works in 5 steps: Read the user's original prompt carefully. → Identify ambiguity, missing context, or… → Rewrite the prompt to remove ambiguity… → …
- A user asks to optimize
- SKILL.md covers Goal, Workflow, Output format and Constraints, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Prompt Optimization is an agent skill from proflead/codex-skills-library. Improve and rewrite user prompts to reduce ambiguity and improve LLM output quality. Use when a user asks to optimize, refine, clarify, or rewrite a prompt for better results, or when the request is about prompt optimization or prompt rewriting.
Its SKILL.md is about 260 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in AI & LLM Engineering, covering Prompt engineering. The repository describes itself as: Codex Skills Library is a curated library of reusable Codex skills for developers, individuals, and teams.
When your agent uses it
- A user asks to optimize
- Rewrite a prompt for better results
- The request is about prompt optimization
- Prompt rewriting
Example prompts
- “/prompt-optimization”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Read the user's original prompt carefully.
- Identify ambiguity, missing context, or unclear intent.
- Rewrite the prompt to remove ambiguity and provide clear instructions.
- Retain the core intention of the user's request.
- Add relevant constraints (format, length, style) when helpful.
What it can do on your machine
Read from SKILL.md and the folder at commit a05260c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Prompt Optimization loads about 263 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 105 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Without a licence we can't republish the file, so here is its outline and opening line. It has 105 words (~263 tokens).
“Improve the user's prompt so Codex (or any LLM) produces better output while preserving intent.”
- name
- prompt-optimization
Files
Just SKILL.md in .codex/skills/prompt-optimization of proflead/codex-skills-library.
Open the folder on GitHubat commit a05260c
Compare with similar skills
Prompt Optimization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Prompt Optimization this skillproflead/codex-skills-library | 155 | — | ~263 | Automated safety check: Pass | None | |
| Prompt Improverseverity1/claude-code-prompt-improver | 1.9k | 1 repos | ~1.7k | Automated safety check: Pass | MIT | |
| Prompt Engineering Patternsynulihao/AgentSkillOS | 618 | 14 repos | ~1.7k | Automated safety check: Pass | None | |
| Patch CreationPiebald-AI/tweakcc | 2.5k | — | ~1.6k | Automated safety check: Pass | MIT | |
| Senior Prompt Engineermaslennikov-ig/claude-code-orchestrator-kit | 260 | 3 repos | ~1.4k | Automated safety check: Pass | Custom licence | |
| Codex Fable5baskduf/FableCodex | 437 | — | ~1.6k | Automated safety check: Pass | AGPL-3.0 |
Similar skills
Prompt Engineering Patterns
ynulihao/AgentSkillOS
Master advanced prompt engineering techniques to maximize LLM performance, reliability, and controllability in production.
Patch Creation
Piebald-AI/tweakcc
Create and register new patches for tweakcc. An agent skill from Piebald-AI/tweakcc.
Senior Prompt Engineer
maslennikov-ig/claude-code-orchestrator-kit
Provides reference guides and Python scripts for prompt optimization, RAG evaluation, and agent orchestration when building or tuning LLM systems.
Codex Fable5
baskduf/FableCodex
Apply a Claude Fable 5 inspired operating style inside Codex.
Prompt Engineering Patterns
wshobson/agents
Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.
More from proflead/codex-skills-library
All 10 skills in this repoBuffer API
proflead/codex-skills-library
Manage Buffer content via the GraphQL API. An agent skill from proflead/codex-skills-library.
Architecture Review
proflead/codex-skills-library
Review a system architecture for scalability, reliability, and maintainability.
Bug Repro Plan
proflead/codex-skills-library
Create a minimal, repeatable reproduction plan for a bug. An agent skill from proflead/codex-skills-library.
Codebase Orientation
proflead/codex-skills-library
Guide quick orientation of an unfamiliar codebase with module mapping, entry points, and local run steps.
Git Basic Helper
proflead/codex-skills-library
Provide safe git commands for common tasks. An agent skill from proflead/codex-skills-library.
Unit Test Starter
proflead/codex-skills-library
Generate starter unit tests for a small function or module. An agent skill from proflead/codex-skills-library.
Related
Categories
Questions about Prompt Optimization
What does Prompt Optimization do?
Improve and rewrite user prompts to reduce ambiguity and improve LLM output quality. Prompt Optimization is an agent skill from proflead/codex-skills-library. Improve and rewrite user prompts to reduce ambiguity and improve LLM output quality.
When should I use Prompt Optimization?
Prompt Optimization fits situations like: A user asks to optimize; rewrite a prompt for better results; the request is about prompt optimization; prompt rewriting.
How do I install Prompt Optimization in Claude Code?
Run `npx skills add proflead/codex-skills-library --skill prompt-optimization -a claude-code`. Or copy the skill folder (.codex/skills/prompt-optimization in proflead/codex-skills-library) into .claude/skills/prompt-optimization in your project. Claude Code loads it when a task matches its description.
How do I install Prompt Optimization in Codex?
Run `npx skills add proflead/codex-skills-library --skill prompt-optimization -a codex`. Or copy the skill folder (.codex/skills/prompt-optimization in proflead/codex-skills-library) into .agents/skills/prompt-optimization in your project. Codex loads it when a task matches its description.
Can I use Prompt Optimization in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add proflead/codex-skills-library --skill prompt-optimization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prompt-optimization, .gemini/skills/prompt-optimization, .github/skills/prompt-optimization and .opencode/skills/prompt-optimization in your project.
What does Prompt Optimization need to run?
SKILL.md names no scripts, command-line tools or credentials: Prompt Optimization is instructions for the agent only.
Does Prompt Optimization access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Prompt Optimization safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Prompt Optimization use?
No licence was found for Prompt Optimization or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.
How many tokens does Prompt Optimization use?
About 263 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Prompt Optimization?
Skills that share tags, products or a category with Prompt Optimization: Prompt Improver (severity1/claude-code-prompt-improver, 1.9k stars), Prompt Engineering Patterns (ynulihao/AgentSkillOS, 618 stars), Patch Creation (Piebald-AI/tweakcc, 2.5k stars) and Senior Prompt Engineer (maslennikov-ig/claude-code-orchestrator-kit, 260 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Prompt Optimization?
proflead (a GitHub user) maintains it in proflead/codex-skills-library, which has 155 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on July 29, 2026.
Source: proflead/codex-skills-library on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.