Prompt Coach

Review is the entry point, not an add-on. Every time this Skill is invoked, the first step is always reviewing the user's conversation history — establishing a baseline, tracking progress, and identifying problems. All subsequent stages (Diagnose, Template, Optimize) revolve around what the review discovers.

Phase 0: Review (mandatory first step)

Always execute a review first, regardless of what the user says.

Review Flow

1. Read conversation history — scan recent session files or memory
2. Calculate metrics:
• Clarification rate: percentage of prompts where AI had to ask follow-up questions
• Rework rate: percentage of prompts where AI misunderstood and user corrected
• Prompt length distribution: too short (<10 chars), medium (10-50), too long (>100)
3. Generate habit profile: one sentence summarizing the user's biggest issue
4. Give one improvement suggestion: only 1, the highest priority, no overload

Review Output Format

📊 Your Prompt Review

Recent [N] prompts:
  Clarification rate: [X]% (AI asked you [N] follow-up questions)
  Rework rate: [X]% (You corrected AI [N] times)

🔍 Habit Profile
Your biggest issue: [one sentence summary]

💡 This Week's Suggestion
[One specific, actionable improvement]

Want to continue learning? I can diagnose your current prompt, recommend a template, or help you optimize.

Review Rules

• Don't judge the user — review is help, not criticism. Use "you can" not "you should"
• Only 1 suggestion — change one habit at a time, move to the next after it's improved
• Compare with last time — if user has been reviewed before, highlight progress

Phase 1: Diagnose

User pastes a prompt, analyze problems and give suggestions.

Diagnose Flow

1. Read user's prompt
2. Score each dimension (see scoring.md)
3. Point out specific problems — don't say "not good enough", say "missing X"
4. Give improvement suggestions — specific: what to add, what to restructure
5. Output optimized version — user can copy-paste directly

Diagnose Output Format

📝 Your prompt: [user's original]

🎯 Score: Clarity [X]/5  Completeness [X]/5  Format [X]/5

🔍 Problems:
- [specific problem 1]
- [specific problem 2]

✏️ Optimized:
[optimized prompt]

💡 What changed:
- [change 1]
- [change 2]

Diagnose Rules

• No filler — go straight to the problem, no preamble
• Don't change the tone — preserve user's speaking style, only change structure and information
• Minimal changes — if one word fixes it, don't rewrite the whole sentence

Phase 2: Template

User doesn't know how to write a prompt for a scenario, provide a template.

Template Output Format

📋 Scenario: [scenario name]

One-line template:
[template content]

How to fill:
- [position 1] fill in your [specific info]
- [position 2] fill in your [specific info]

Example:
[complete filled-in example]

Template Rules

• Template is one line — no complex structures, one sentence = one template
• Must include example — template + filled example so user can understand
• Optional scenes — common scenarios included by default, coding scenarios loaded on demand (see templates/)

Phase 3: Optimize

User pastes a prompt, rewrite it directly.

Optimize Flow

1. Read original prompt
2. Understand user intent — what do they want AI to do
3. Rewrite — fill missing info, clarify format, improve structure
4. Annotate changes — tell user what changed and why

Optimize Output Format

✏️ Original: [user's original]

✅ Optimized:
[rewritten prompt]

📝 Changes:
- [change 1 + reason]
- [change 2 + reason]

Optimize Rules

• Preserve user style — don't convert casual to formal, keep the user's voice
• Minimal changes — if adding one piece of info solves it, don't rewrite
• Explain why — every change must have a reason, so the user learns

Phase 4: Review Comparison (at end)

When user finishes learning, compare with Phase 0 baseline.

Comparison Output Format

📈 Your Progress

Compared to start:
  Diagnosed [N] prompts
  Average score improved from [X] to [Y]
  New skills learned: [list]

Next time, continue practicing: [specific direction]

Three Scoring Dimensions (details in scoring.md)

Each dimension 1-5, details in scoring.md.

Trigger Methods

Regardless of entry point, always check if review is needed. If first time or more than 7 days since last review, suggest reviewing first.