prompt-rewriter
Prompt Rewriter
Overview
Help users transform vague, ineffective prompts into powerful, well-structured instructions that produce consistent, high-quality results from AI models. Analyzes prompts across multiple quality dimensions and provides actionable suggestions.
Quick Start
User says: "Help me rewrite this prompt: 'Write a blog post about AI'"
You should:
- Analyze the original prompt's weaknesses (too vague, no audience specified, no format defined)
- Identify improvement areas (add topic specificity, target audience, tone, length, structure)
- Provide 2-3 rewrite options with different approaches
- Explain the changes and why they matter
Core Capabilities
1. Prompt Quality Analysis
Evaluate prompts across five key dimensions:
Clarity (0-2)
- Is the request unambiguous?
- Are terms defined?
- Can Claude understand without clarification?
Specificity (0-2)
- Are constraints clear?
- Is output format specified?
- Are boundaries defined?
Structure (0-2)
- Is information organized logically?
- Are steps clear if applicable?
- Is there a framework?
Completeness (0-2)
- Is sufficient context provided?
- Are requirements comprehensive?
- Is missing information flagged?
Usability (0-2)
- Is it reusable?
- Can it be adapted easily?
- Is the language natural?
Scoring:
- 8-10: Excellent prompt, minor tweaks needed
- 6-7: Good prompt, moderate improvements possible
- 4-5: Functional but has significant weaknesses
- 0-3: Poor prompt, needs major rework
2. Rewrite Generation
Generate 2-3 rewrite variations using different approaches:
Variation 1: Conservative Fix
- Keep original intent
- Add specificity and structure
- Minimal stylistic changes
- Best when user wants to preserve voice
Variation 2: Technique Enhancement
- Apply prompt engineering patterns (CoT, few-shot, etc.)
- Add advanced techniques
- Focus on effectiveness
- Best when user wants optimal results
Variation 3: Simplification
- Strip complexity while keeping core request
- Make more conversational
- Focus on ease of use
- Best for beginners or quick tasks
3. Improvement Explanation
For each rewrite, explain:
- What changed (specific modifications)
- Why it matters (impact on AI output)
- When to use (appropriate scenarios)
4. Pattern Application
Apply proven prompt engineering techniques:
Chain of Thought (CoT)
- "Let's think step by step"
- "First, analyze... Then, evaluate..."
- Best for: complex reasoning, math, logic
Few-Shot Learning
- Provide 2-3 examples before request
- Pattern: Example 1 → Example 2 → Example 3 → Your task
- Best for: format specification, style matching
Role-Based Prompts
- "Act as a senior engineer..."
- "You are a marketing expert..."
- Best for: specialized knowledge, tone control
Output Structure
- Use templates and headers
- Define sections explicitly
- Best for: reports, documentation, structured content
Constraint Definition
- "Limit response to 500 words"
- "Exclude jargon for non-technical audience"
- Best for: length control, accessibility
5. A/B Testing Guidance
Help users test prompts effectively:
- Generate variations systematically
- Suggest test methodology
- Recommend evaluation criteria
Workflow
Step 1: Receive and Analyze
- Extract the prompt to rewrite
- Identify user's intent (what do they want to achieve?)
- Check for constraints (tone, format, length, audience)
- Evaluate against 5 quality dimensions
- Calculate score and identify primary weaknesses
Step 2: Generate Rewrites
- Variation 1 (Conservative): Add structure, clarify terms, define output
- Variation 2 (Technique-Enhanced): Apply relevant patterns (CoT, few-shot, etc.)
- Variation 3 (Simplified): Make conversational, reduce complexity
Step 3: Present Options
For each rewrite:
- Show the improved prompt
- Explain the changes
- Highlight which techniques were used
- Recommend which to use based on context
Step 4: Educational Component
Briefly explain:
- Which prompt engineering techniques were applied
- Why they work in this context
- How the user can apply them in future prompts
Common Patterns and Fixes
Pattern: Too Vague
Weak: "Write about climate change" Fix: Add specificity - audience, purpose, format, depth
Strong: "Write a 1000-word blog post for a general audience explaining climate change's causes, effects, and potential solutions. Use an optimistic but realistic tone. Include: (1) introduction with hook, (2) 3 main sections with data, (3) conclusion with actionable advice."
Pattern: No Structure
Weak: "Analyze this data" Fix: Add framework or step-by-step instructions
Strong: "Analyze the sales data provided. Structure your response as:
- Executive Summary (3 bullet points of key findings)
- Detailed Analysis (break down by region and product)
- Trend Identification (what patterns emerge?)
- Recommendations (3 actionable steps based on data)"
Pattern: Missing Context
Weak: "Improve this email" Fix: Add context about audience, goal, constraints
Strong: "Improve this email for a C-level executive audience. Goal: Get approval for a $50k project. Keep it under 200 words. Tone: Professional but persuasive. Current email: [paste]"
Pattern: Unclear Output Format
Weak: "Create marketing content" Fix: Specify format, style, deliverables
Strong: "Create marketing content for our new product launch. Deliver:
- Social media post (LinkedIn, 150 words, professional tone)
- Email blurb (75 words, excitement-focused)
- Website headline (catchy, under 10 words)
- 3 key benefits (each under 15 words)"
Examples
Example 1: Content Creation
Input Prompt: "Write an article about remote work"
Analysis:
- Clarity: 1/2 (clear topic but vague on specifics)
- Specificity: 0/2 (no format, audience, length)
- Structure: 0/2 (no framework)
- Completeness: 0/2 (missing key details)
- Usability: 1/2 (somewhat reusable)
- Score: 2/10 - Major weaknesses across dimensions
Rewrite Option 1 (Conservative):
Write a 1500-word article about remote work for business professionals. Cover:
1. Benefits of remote work (productivity, cost savings, flexibility)
2. Challenges (isolation, communication, work-life balance)
3. Best practices for success (routine, communication tools, workspace setup)
4. Future trends (hybrid models, technology evolution)
Tone: Informative and balanced
Format: Use headings and bullet points
Rewrite Option 2 (Technique-Enhanced):
Act as an experienced remote work consultant. Write a comprehensive article about remote work for business leaders considering transitioning their teams.
Structure your response using the following framework:
**Introduction (150 words)**
- Hook with a surprising statistic
- Briefly state the article's purpose
- Outline what will be covered
**Section 1: The Business Case (400 words)**
Let's think about this step by step:
- Analyze cost benefits (real estate, equipment, turnover)
- Evaluate productivity studies (with data sources)
- Consider talent access (hiring from anywhere)
**Section 2: Implementation Challenges (350 words)**
- Communication breakdowns (provide examples)
- Culture maintenance (specific strategies)
- Performance management (tools and metrics)
**Section 3: Success Framework (400 words)**
Provide a concrete 90-day rollout plan:
- Month 1: Foundation and tools
- Month 2: Training and feedback
- Month 3: Optimization and refinement
**Conclusion (200 words)**
- Summarize key takeaways
- Provide 3 actionable next steps
- End with an inspiring vision
Tone: Professional yet engaging
Examples: Include 2-3 real company case studies
Rewrite Option 3 (Simplified):
Write an article about remote work. Make it about 1500 words long and aimed at business people who are thinking about letting employees work from home. Talk about:
- Why it's good (saves money, people like it)
- What's hard (staying in touch, managing performance)
- How to do it right (tools, schedules, clear expectations)
Use a helpful, informative tone with clear headings.
Recommendation: Use Option 2 if the user wants maximum impact. Use Option 1 for clarity and professionalism. Use Option 3 for quick, casual needs.
Example 2: Code Review
Input Prompt: "Review this code"
Analysis:
- Clarity: 0/2 (completely unclear what to look for)
- Specificity: 0/2 (no criteria, no scope)
- Structure: 0/2 (no framework)
- Completeness: 0/2 (missing all context)
- Usability: 0/2 (not reusable)
- Score: 0/10 - Needs complete rework
Rewrite Option 1 (Conservative):
Review the code provided below. Focus on:
1. Bugs or errors
2. Performance issues
3. Code style and readability
4. Potential security vulnerabilities
Provide specific line references and suggestions for each issue found.
Rewrite Option 2 (Technique-Enhanced):
Act as a senior software engineer conducting a thorough code review. Analyze the provided code following this systematic approach:
**Step 1: Functional Analysis**
Let's check if the code works correctly:
- Verify logic correctness (walk through execution)
- Check edge cases (null inputs, empty arrays, boundary conditions)
- Validate error handling (try-catch blocks, meaningful error messages)
**Step 2: Performance Evaluation**
Analyze computational complexity:
- Time complexity: Big-O notation
- Space complexity: Memory usage
- Identify any O(n²) or worse bottlenecks
- Suggest optimization opportunities
**Step 3: Security Review**
Look for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Improper input validation
- Sensitive data exposure
**Step 4: Code Quality**
Assess adherence to best practices:
- Naming conventions (descriptive, consistent)
- Comments (helpful, not redundant)
- DRY principle (Don't Repeat Yourself)
- Single Responsibility Principle
**Step 5: Recommendations**
Provide:
- Priority-ranked list of issues (Critical > High > Medium > Low)
- Specific code examples for fixes
- Refactoring suggestions for improvement
Code to review:
Rewrite Option 3 (Simplified):
Look at this code and tell me what's wrong or could be better. Check for bugs, slow parts, security issues, and things that are hard to understand. Give me specific suggestions with examples.
Code:
Recommendation: Option 2 is best for professional code reviews. Option 1 works for quick checks. Use Option 3 for informal feedback or beginners.
Example 3: Email Writing
Input Prompt: "Write an email asking for a meeting"
Analysis:
- Clarity: 1/2 (clear intent but vague context)
- Specificity: 0/2 (no purpose, no agenda, no recipient type)
- Structure: 0/2 (no format)
- Completeness: 0/2 (missing all details)
- Usability: 1/2 (somewhat reusable)
- Score: 2/10 - Needs major improvement
Rewrite Option 1 (Conservative):
Write an email requesting a meeting with [recipient name]. Purpose: Discuss [topic].
Include:
- Brief introduction (context)
- Meeting purpose (why we need to meet)
- Proposed agenda (3-4 bullet points)
- Suggested time options (provide 2-3 alternatives)
- Call to action (confirmation request)
Tone: Professional and respectful
Length: Under 200 words
Rewrite Option 2 (Technique-Enhanced):
Act as an executive assistant drafting a meeting request email to [recipient type, e.g., senior executive/client].
Context: We need to discuss [specific topic] to [desired outcome].
Apply these principles:
**Subject Line Best Practice**
Make it specific and actionable: "Meeting Request: [Topic] - [Urgency/Timeframe]"
Example: "Meeting Request: Q1 Strategy Alignment - This Week"
**Opening Strategy**
First, establish relevance in 1 sentence:
- Reference prior conversation
- Mention shared goal or project
- Acknowledge their value/time
**Value Proposition Frame**
Instead of "I want to meet," use "We'll achieve X by meeting together":
- "In 30 minutes, we can finalize the project timeline"
- "This discussion will unblock the next phase of development"
**Agenda Structure**
Use the SCQA framework:
1. **Situation** (current state)
2. **Complication** (what's blocking us)
3. **Question** (decision needed)
4. **Answer** (your recommendation)
**Time Options Psychology**
Offer specific times with psychological anchors:
- Tuesday 2pm (after lunch, high energy)
- Thursday 10am (start of week, fresh)
- Friday 3pm (end of week, closure mindset)
**Closing**
Make it easy to say yes:
- "If these don't work, suggest your best time"
- "I'll adjust to accommodate your schedule"
Tone: Respectful of their time, clear on value
Length: 150-180 words
Rewrite Option 3 (Simplified):
Write a short email asking for a meeting with [name]. We need to talk about [topic]. Suggest a few times that would work, mention what we'll cover, and ask them to confirm. Keep it friendly and brief.
Recommendation: Option 2 is ideal for important business communications. Option 1 works for routine internal emails. Option 3 is fine for casual requests.
Advanced Techniques
Multiple Rewrites for A/B Testing
When users need to test prompts systematically:
- Control: The original prompt
- Variation A: Change one variable (e.g., add examples)
- Variation B: Change a different variable (e.g., add role)
- Variation C: Combine A + B
Suggest testing methodology:
- Run each prompt 3-5 times with same input
- Evaluate outputs on criteria (quality, consistency, usefulness)
- Track which variation performs best
Iterative Improvement
Guide users through multiple rounds:
Round 1: Initial rewrite (address major weaknesses) Round 2: Refine based on feedback (what worked, what didn't) Round 3: Polish (fine-tune for specific use case)
Each round should:
- Show what changed
- Explain the reasoning
- Ask for specific feedback
Context Injection
When prompts lack context, guide users to add it:
Ask these questions:
- Who is the audience?
- What is the goal/purpose?
- What constraints exist (length, tone, format)?
- What background is assumed?
- What should the output look like?
Then incorporate answers into the rewrite.
When to Use This Skill
Trigger when users say:
- "Rewrite this prompt"
- "Make this prompt better"
- "Improve my prompt"
- "Why isn't this prompt working?"
- "Help me write a better prompt for..."
- "Generate variations of this prompt"
- "A/B test this prompt"
Resources
scripts/
No scripts required for this skill - all analysis and rewriting is done by Claude directly.
references/
No references required - prompt engineering techniques are documented inline.
assets/
No assets required - this skill generates text output only.