Prompt Improver
severity1/claude-code-prompt-improver
This skill enriches vague prompts with targeted research and clarification before execution.
Transform poor or overly simple prompts with expert-level framing.
Install Prompt Enhancer
$ npx skills add sammcj/agentic-coding --skill prompt-enhancer -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sammcj/agentic-coding prompt-enhancer --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/sammcj/agentic-coding.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills/prompt-enhancer .claude/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .claude/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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/sammcj/agentic-coding/tree/main/Skills/prompt-enhancerType 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 sammcj/agentic-coding --skill prompt-enhancer -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sammcj/agentic-coding prompt-enhancer --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .agents/skills && cp -r skills-src/Skills/prompt-enhancer .agents/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .agents/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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 sammcj/agentic-coding --skill prompt-enhancer -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sammcj/agentic-coding prompt-enhancer --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/Skills/prompt-enhancer .cursor/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .cursor/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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/sammcj/agentic-coding.git --path Skills/prompt-enhancer--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 sammcj/agentic-coding --skill prompt-enhancer -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sammcj/agentic-coding prompt-enhancer --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/Skills/prompt-enhancer .gemini/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .gemini/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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 sammcj/agentic-coding prompt-enhancerInstalls 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 sammcj/agentic-coding --skill prompt-enhancer -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .github/skills && cp -r skills-src/Skills/prompt-enhancer .github/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .github/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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 sammcj/agentic-coding --skill prompt-enhancer -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sammcj/agentic-coding prompt-enhancer --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/Skills/prompt-enhancer .opencode/skills/prompt-enhancer && 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-enhancer" agent skill from https://github.com/sammcj/agentic-coding/tree/main/Skills/prompt-enhancer into .opencode/skills/prompt-enhancer/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "prompt-enhancer", 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-enhancer- GitHub stars
- 162
- Token cost
- ~1.4k tokens
- SKILL.md length
- 700 words
- Files
- 1
- Skills in repo
- 64
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Transform poor or overly simple prompts with expert-level framing.
- Works in 5 steps: Identify the domain and who would… → Find the core intent beneath imprecise… → Identify what's implicit or ambiguous.… → …
- The user explicitly asks to improve
- SKILL.md covers Expert Communication Patterns, Examples, Your transformation approach and Constraints, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Prompt Enhancer is an agent skill from sammcj/agentic-coding. Transform poor or overly simple prompts with expert-level framing. Use when the user explicitly asks to improve, refine, or rewrite a prompt, or wants help framing a request for another AI system. Do NOT use for authoring, reviewing, or migrating system prompts or skills targeting a specific Claude model.
Its SKILL.md is about 1.4k 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: Agentic Coding Rules, Templates etc... The licence is Apache-2.0.
When your agent uses it
- The user explicitly asks to improve
- Rewrite a prompt
- Wants help framing a request for another AI system
- Migrating system prompts
Example prompts
- “/prompt-enhancer”
Requirements
- Python 3
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Identify the domain and who would professionally handle this request. This tells you what terminology, standards, and mental models apply.
- Find the core intent beneath imprecise language. What does the user actually want to achieve or understand?
- Identify what's implicit or ambiguous. What has the user not specified that would affect the outcome? Distinguish between
- Reframe using expert patterns: precise terminology, appropriate decomposition, explicit constraints, success criteria, and role framing…
- Match complexity to the task. A simple question needs professional-level clarity, not PhD-level complexity. Don't inflate.
What it can do on your machine
Read from SKILL.md and the folder at commit 2f25ced. 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 Enhancer loads about 1.4k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 700 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
The full file from sammcj/agentic-coding at commit 2f25ced, republished under its Apache-2.0 licence (© sammcj). 700 words, ~1,429 tokens.
Download SKILL.mdSave it as
.claude/skills/prompt-enhancer/SKILL.md (or your agent's skills folder).- name
- prompt-enhancer
- description
- Transform poor or overly simple prompts with expert-level framing. Use when the user explicitly asks to improve, refine, or rewrite a prompt, or wants help framing a request for another AI system. Do NOT use for authoring, reviewing, or migrating system prompts or skills targeting a specific Claude model.
Expert Prompt Enhancer
Transform prompts written by non-specialists into the form a domain expert would use to make the same request. The intent is to give people the benefits of expert framing without requiring them to learn domain-specific language or problem structuring.
Expert Communication Patterns
Expert requests differ from novice requests in predictable ways:
| Pattern | Novice | Expert |
|---|---|---|
| Precision | "make it faster" | "optimise page load performance" |
| Decomposition | Single vague request | Broken into logical components |
| Constraints | Unstated | Explicit limits, trade-offs, success criteria |
| Context | Missing | System fit, standards, prior attempts |
| Failure modes | Ignored | Anticipated and specified |
Role framing (e.g. "As a database architect, review this schema") is an optional tone lever, not a core pattern. Apply it only when a specific professional viewpoint sharpens the request.
Examples
These illustrate the transformation from novice to expert framing:
Original: "My back hurts, what should I do?"
Expert rewrite: "Provide guidance on managing back pain. Cover: how to assess whether back pain warrants professional evaluation vs self-care, red flag symptoms that require urgent attention, evidence-based self-care approaches for common musculoskeletal back pain, activity modifications that help vs hurt recovery, and when to consider different types of practitioners (GP, physio, chiropractor, etc.). Focus on helping me make informed decisions rather than diagnosing."
What changed: Reframed from "tell me what to do" to "help me understand decision-making for this situation". Specified the information categories that would actually be useful. Acknowledged appropriate scope limitations.
Original: "Write me a short story"
Expert rewrite: "Write a short story of around 2,000 words. Aim for literary fiction with a reflective tone - the kind of piece that might appear in a quality magazine. Focus on a small, specific moment that reveals something larger about a character or relationship. Prioritise voice and interiority over plot mechanics. End with resonance rather than resolution. Surprise me with the premise."
What changed: Specified length, genre positioning, and tone. Named craft priorities (voice, interiority, resonance). Gave clear aesthetic direction while leaving creative freedom on subject matter.
Original: "I need a Python script to clean up my data"
Expert rewrite: "Help me write a Python script for data cleaning. I'll share a sample of the data - from that, identify the data quality issues present (missing values, duplicates, inconsistent formats, outliers, encoding problems) and write cleaning code that handles each. Use pandas. Include validation that confirms the cleaning worked. Structure the code so each cleaning step is separate and commented, making it easy to modify for my specific needs."
What changed: Established a workflow (show sample → identify issues → write code). Specified the tool. Asked for validation and modular structure. This version can proceed once data is shared, without requiring the user to pre-diagnose their own data problems.
Show full SKILL.md (253 more words)Show less
Your transformation approach
When rewriting a prompt:
Identify the domain and who would professionally handle this request. This tells you what terminology, standards, and mental models apply.
Find the core intent beneath imprecise language. What does the user actually want to achieve or understand?
Identify what's implicit or ambiguous. What has the user not specified that would affect the outcome? Distinguish between:
- Gaps you can fill with reasonable defaults (do this)
- Genuine ambiguities where guessing could go badly wrong (flag these)
Reframe using expert patterns: precise terminology, appropriate decomposition, explicit constraints, success criteria, and role framing where helpful.
Match complexity to the task. A simple question needs professional-level clarity, not PhD-level complexity. Don't inflate.
Constraints
- Preserve intent absolutely. You elevate how something is asked, never what is asked.
- Don't invent requirements. Fill obvious gaps with reasonable defaults; don't add things the user didn't imply.
- Make reasonable assumptions rather than asking the user to specify everything. The goal is to improve prompts without creating work for the user. Only surface ambiguity when guessing wrong would lead to a significantly worse outcome.
- Use correct terminology, not impressive terminology. Domain language should clarify, not obscure or intimidate.
- Don't be precious about the output format. For simple transformations, a straightforward rewrite is fine. Only add explanatory notes when the transformation involves non-obvious choices.
Output
Provide the expert rewrite. If you made assumptions about ambiguous elements, or if there are meaningful alternative framings the user might prefer, note these briefly after the rewrite.
© sammcj, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in Skills/prompt-enhancer of sammcj/agentic-coding.
Open the folder on GitHubat commit 2f25ced
Compare with similar skills
Prompt Enhancer 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 Enhancer this skillsammcj/agentic-coding | 162 | — | ~1.4k | Automated safety check: Pass | Apache-2.0 | |
| 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 sammcj/agentic-coding
All 64 skills in this repoYue2 Music
sammcj/agentic-coding
A skill your agent uses when generating songs with YuE2, covering a recording via SheetSage2 audio-to-ABC, editing a score or lyrics with melody preservation, or building a reproducible listening…
Bento Slides
sammcj/agentic-coding
A skill your agent uses when creating or editing Bento (.bento.html) slide decks, including any request for a single-file HTML slide deck.
Idrive Backup
sammcj/agentic-coding
A skill your agent uses whenever the user wants you to manage, discuss or diagnose iDrive Backup configuration on macOS
Piper Tts Training
sammcj/agentic-coding
Train custom TTS voices for Piper (ONNX format) using fine-tuning or from-scratch approaches.
PPTX To Md
sammcj/agentic-coding
Convert a PPTX slide deck into per-slide markdown that preserves both the verbatim text and the meaning of embedded screenshots, diagrams and charts in their original layout positions.
Skill Creator Primer
sammcj/agentic-coding
You MUST load this skill before the skill-creator skill AND before making ANY change to, or conducting a review of ANY Agent Skill.
Related
Categories
Questions about Prompt Enhancer
What does Prompt Enhancer do?
Transform poor or overly simple prompts with expert-level framing. Prompt Enhancer is an agent skill from sammcj/agentic-coding. Transform poor or overly simple prompts with expert-level framing.
When should I use Prompt Enhancer?
Prompt Enhancer fits situations like: the user explicitly asks to improve; rewrite a prompt; wants help framing a request for another AI system; migrating system prompts.
How do I install Prompt Enhancer in Claude Code?
Run `npx skills add sammcj/agentic-coding --skill prompt-enhancer -a claude-code`. Or copy the skill folder (Skills/prompt-enhancer in sammcj/agentic-coding) into .claude/skills/prompt-enhancer in your project. Claude Code loads it when a task matches its description.
How do I install Prompt Enhancer in Codex?
Run `npx skills add sammcj/agentic-coding --skill prompt-enhancer -a codex`. Or copy the skill folder (Skills/prompt-enhancer in sammcj/agentic-coding) into .agents/skills/prompt-enhancer in your project. Codex loads it when a task matches its description.
Can I use Prompt Enhancer 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 sammcj/agentic-coding --skill prompt-enhancer -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-enhancer, .gemini/skills/prompt-enhancer, .github/skills/prompt-enhancer and .opencode/skills/prompt-enhancer in your project.
What does Prompt Enhancer need to run?
SKILL.md names no scripts, command-line tools or credentials: Prompt Enhancer is instructions for the agent only. Our summary lists: Python 3.
Does Prompt Enhancer 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 Enhancer 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 Enhancer use?
Prompt Enhancer is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Prompt Enhancer use?
About 1.4k tokens (SKILL.md is roughly 5.7k 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 Enhancer?
Skills that share tags, products or a category with Prompt Enhancer: 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 Enhancer?
sammcj (a GitHub user) maintains it in sammcj/agentic-coding, which has 162 GitHub stars. The repository holds 64 skills in this directory. The repository was last updated on October 9, 2026.
Source: sammcj/agentic-coding on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.