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?

1. Identify improvements — List specific weaknesses with line references
2. Generate rewrites — Provide improved versions preserving original intent
3. 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:

description: Does stuff with code

After:

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 gu