Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness.

MITAuto-check passedAI & LLM Engineering

Install Prompt Improver

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill prompt-improver -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace prompt-improver --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/prompt-improver .claude/skills/prompt-improver && rm -rf skills-src

Use ~/.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/

Facts

Skill name
prompt-improver
GitHub stars
2.8k
Token cost
~1.2k tokens
SKILL.md length
392 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness.

  • Works in 6 steps: Identify the target — Locate the… → Read the content — Use Read tool to get… → Score each dimension on a 1-5 scale → …
  • The user asks to improve a prompt
  • SKILL.md covers Overview, When to Use This Skill, Instructions and Output Format, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Prompt Improver is an agent skill from jeremylongshore/tons-of-skills-marketplace. Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness. Use when the user asks to "improve a prompt", "review a skill", "enhance instructions", "make this prompt better", "optimize this command", or "audit prompt quality".

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/severity-levels.md`). Compatibility notes: Designed for Claude Code

It sits in AI & LLM Engineering, covering Prompt engineering. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • The user asks to improve a prompt
  • Enhance instructions
  • Make this prompt better
  • Optimize this command

Example prompts

  • “improve a prompt”
  • “review a skill”
  • “enhance instructions”
  • “/prompt-improver”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Identify the target — Locate the SKILL.md, command, or agent file to analyze
  2. Read the content — Use Read tool to get the full file contents
  3. Score each dimension on a 1-5 scale
  4. Identify improvements — List specific weaknesses with line references
  5. Generate rewrites — Provide improved versions preserving original intent
  6. Apply changes — If requested, use Edit tool to apply improvements

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • code.claude.com
    • platform.claude.com

    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.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Prompt Improver loads about 1.2k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 76 tokens; SKILL.md has 392 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.7k

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 jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 392 words, ~1,171 tokens.

Download SKILL.mdSave it as .claude/skills/prompt-improver/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
prompt-improver
description
Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness. Use when the user asks to "improve a prompt", "review a skill", "enhance instructions", "make this prompt better", "optimize this command", or "audit prompt quality".
allowed-tools
Read, Write, Edit, Glob, Grep
compatibility
Designed for Claude Code
version
1.7.0
author
severity1 <severity1@intentsolutions.io>
license
MIT
tags
security, compliance

Prompt Improver

This skill automatically analyzes and improves plugin prompts, SKILL.md files, command definitions, and agent instructions.

Overview

The prompt-improver skill evaluates plugin content across five dimensions — clarity, safety, effectiveness, completeness, and conciseness — then provides scored assessments and concrete rewrites.

When to Use This Skill

This skill activates when you need to:

  • Review and improve a SKILL.md file's instructions
  • Enhance command or agent markdown definitions
  • Audit prompt quality across a plugin
  • Optimize instructions for better Claude performance
  • Ensure prompts follow marketplace best practices

Instructions

  1. Identify the target — Locate the SKILL.md, command, or agent file to analyze
  2. Read the content — Use Read tool to get the full file contents
  3. Score each dimension on a 1-5 scale:
    • Clarity (1-5): Are instructions unambiguous?
    • Safety (1-5): Does it avoid encouraging dangerous operations?
    • Effectiveness (1-5): Will it reliably produce intended results?
    • Completeness (1-5): Are edge cases addressed?
    • Conciseness (1-5): Is it free of unnecessary verbosity?
  4. Identify improvements — List specific weaknesses with line references
  5. Generate rewrites — Provide improved versions preserving original intent
  6. Apply changes — If requested, use Edit tool to apply improvements

Output Format

## Prompt Analysis: [filename]

### Scores
| Dimension | Score | Notes |
|-----------|-------|-------|
| Clarity | X/5 | ... |
| Safety | X/5 | ... |
| Effectiveness | X/5 | ... |
| Completeness | X/5 | ... |
| Conciseness | X/5 | ... |

**Overall: X/25**

### Improvements
1. [Specific improvement with before/after]

### Suggested Rewrite
[Full improved prompt text]

Best Practices

  • Preserve the original author's intent and style
  • Prioritize safety improvements over stylistic ones
  • Keep suggestions actionable and specific
  • Reference marketplace conventions from CLAUDE.md
  • Validate frontmatter fields match the 2026 spec

Examples

Example 1: Improving a vague skill description

Before:

yaml
description: Does stuff with code

After:

yaml
description: |
  Analyze source code for common anti-patterns and suggest refactoring improvements. Use when the user asks to "review code quality", "find code smells", or "refactor this file".
Example 2: Adding missing safety guidance

Before:

markdown
Delete all temporary files from the project.

After:

markdown
Identify temporary files (*.tmp, *.bak, *.swp) in the project. List them for user confirmation before deletion. Never delete files outside the project root.
Show full SKILL.md (158 more words)Show less

Prerequisites

  • A plugin directory containing at least one SKILL.md, command, or agent markdown file
  • Read access to the target plugin's .claude-plugin/plugin.json for context
  • Familiarity with the 2026 SKILL.md frontmatter spec

Output

The skill produces a structured analysis report containing:

  • Score card: 5 dimensions rated 1-5 with notes and an overall score out of 25
  • Improvement list: Specific weaknesses with file paths and line references
  • Suggested rewrite: Full improved prompt text preserving original intent

Error Handling

ErrorCauseResolution
No SKILL.md foundTarget path has no skill filesVerify the plugin path and check for skills/*/SKILL.md
Invalid frontmatterYAML parsing failure in target fileReport the specific YAML error and suggest corrections
Empty skill bodyFile has frontmatter but no instructionsFlag as critical and generate a starter template

Resources

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/prompt-improver of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/severity-levels.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Prompt Improver 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.

Prompt Improver compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Prompt Improver this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.2kAutomated safety check: PassMIT
Codex Fable5baskduf/FableCodex437—~1.6kAutomated safety check: PassAGPL-3.0
Prompt Template Authoringnicobailon/pi-prompt-template-model321—~1.3kAutomated safety check: PassMIT
Context Auditundefined-ui/second-brain-os1k—~802Automated safety check: PassMIT
Asd Ste100 SkillTwiTech-LAB/devchain101—~1.2kAutomated safety check: PassMIT
AI Chatwindmill-labs/windmill18k—~672Automated safety check: PassCustom licence

Similar skills

  • Codex Fable5

    baskduf/FableCodex

    Apply a Claude Fable 5 inspired operating style inside Codex.

    437 GitHub stars~1.6k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Prompt Template Authoring

    nicobailon/pi-prompt-template-model

    Write and run custom Pi prompt templates (slash commands) for this extension.

    321 GitHub stars~1.3k tokensUpdated 19 days ago
    AI & LLM EngineeringAuto-check passed
  • Context Audit

    undefined-ui/second-brain-os

    Audit an agent's context layout against the four places: system prompt, tools, history, tail.

    1k GitHub stars~802 tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Asd Ste100 Skill

    TwiTech-LAB/devchain

    Write or rewrite English with ASD-STE100 Simplified Technical English rules: one meaning per word, active voice, simple tenses, one instruction per sentence.

    101 GitHub stars~1.2k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • AI Chat

    windmill-labs/windmill

    Guidance for improving the Windmill AI chat (copilot), especially global mode — tools, prompts, and context-window discipline.

    18k GitHub stars~672 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • A skill your agent uses when building custom Kiro AI agents or when user asks for agent configurations - provides JSON structure, tool configuration, prompt patterns, and security best practices for…

    122 GitHub stars~1.9k tokensUpdated 4 days ago
    AI & LLM EngineeringAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Prompt Improver

What does Prompt Improver do?

Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness. Prompt Improver is an agent skill from jeremylongshore/tons-of-skills-marketplace. Analyze and improve plugin prompts, skill definitions, and command instructions for clarity, safety, and effectiveness.

When should I use Prompt Improver?

Prompt Improver fits situations like: the user asks to improve a prompt; enhance instructions; make this prompt better; optimize this command.

How do I install Prompt Improver in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill prompt-improver -a claude-code`. Or copy the skill folder (skills/.curated/prompt-improver in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/prompt-improver in your project. Claude Code loads it when a task matches its description.

How do I install Prompt Improver in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill prompt-improver -a codex`. Or copy the skill folder (skills/.curated/prompt-improver in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/prompt-improver in your project. Codex loads it when a task matches its description.

Can I use Prompt Improver 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 jeremylongshore/tons-of-skills-marketplace --skill prompt-improver -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-improver, .gemini/skills/prompt-improver, .github/skills/prompt-improver and .opencode/skills/prompt-improver in your project.

What does Prompt Improver need to run?

SKILL.md names no scripts, command-line tools or credentials: Prompt Improver is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep. Compatibility (from SKILL.md): Designed for Claude Code.

Does Prompt Improver access the network?

SKILL.md names 2 domains. As links in the text: code.claude.com and platform.claude.com. This is read from the text; nothing was executed.

Is Prompt Improver 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 Improver use?

Prompt Improver is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Prompt Improver use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 530 tokens, read only when the agent opens those files.

What are the alternatives to Prompt Improver?

Skills that share tags, products or a category with Prompt Improver: Codex Fable5 (baskduf/FableCodex, 437 stars), Prompt Template Authoring (nicobailon/pi-prompt-template-model, 321 stars), Context Audit (undefined-ui/second-brain-os, 1k stars) and Asd Ste100 Skill (TwiTech-LAB/devchain, 101 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Prompt Improver?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.