⚡ Prompt Reviewer

Prompt Reviewer works like Grammarly — but for AI prompts. It scores your prompt from 0–100, detects missing elements, lints for common mistakes, and generates an improved version — all inside VS Code and Windsurf.

🚀 Quick Start (3 Steps)

Step 1 — Press Ctrl+N to open a new file

Step 2 — Type your prompt in the editor:

Write a login function in TypeScript using Express

Step 3 — Press Ctrl+Shift+P → type Analyze Prompt → press Enter

The Prompt Reviewer panel opens on the left and shows your score, issues, and an improved version.

⚠️ Important: Always keep your cursor inside the editor before clicking Analyze. Clicking the panel first causes "No active editor" error.

📦 Installation

From VS Code Marketplace

1. Open Extensions panel Ctrl+Shift+X
2. Search "Prompt Reviewer"
3. Click Install

From Windsurf

1. Open Extensions panel Ctrl+Shift+X
2. Search "Prompt Reviewer"
3. Click Install

🎯 How to Use

Analyze a Prompt

1. Open any file (Ctrl+N for a new file)
2. Type or paste your prompt in the editor
3. Either:
   • Press Ctrl+Shift+P → Prompt Reviewer: Analyze Prompt
   • Or right-click selected text → Analyze Prompt
4. The panel shows your score, issues, and suggestions

Improve a Prompt

1. Type your prompt in the editor
2. Press Ctrl+Shift+P → Prompt Reviewer: Improve Prompt
3. In the panel, scroll to Improved Prompt and click to expand
4. Click ↩ Replace in Editor to apply the improved version
5. Copy the improved prompt and paste it into your AI chat

Use a Template

Templates are ready-made prompt structures for common tasks.

1. Press Ctrl+Shift+P → Prompt Reviewer: Insert Template
2. Choose a template from the list:
   • Code Generation
   • Bug Fix
   • API Development
   • Architecture Design
   • Database Design
   • Testing
   • Documentation
   • PRD Writing
   • Refactoring
   • Code Review
3. The template inserts into your editor
4. Replace [PLACEHOLDER] values with your actual details

View Prompt History

See your last 50 analyzed prompts:

Press Ctrl+Shift+P → Prompt Reviewer: Open Prompt History

Click any entry to reload that analysis in the panel.

📊 Understanding Your Score

Your prompt is scored from 0 to 100 across 8 dimensions:

Quality Labels

⚠️ Lint Rules

The extension checks your prompt against 11 rules:

🤖 Enable AI-Powered Improvements (Optional)

By default, the extension uses a built-in template engine to improve prompts. You can optionally connect a real AI for better results.

Setup

Press Ctrl+, and search promptReviewer, then configure:

Supported Providers

Gemini (Free)

"promptReviewer.aiProvider": "gemini",
"promptReviewer.aiApiKey": "YOUR-GEMINI-KEY"

Get a free key at: https://aistudio.google.com/app/apikey

Claude (Anthropic)

"promptReviewer.aiProvider": "claude",
"promptReviewer.aiApiKey": "sk-ant-YOUR-KEY"

Get a key at: https://console.anthropic.com

OpenAI

"promptReviewer.aiProvider": "openai",
"promptReviewer.aiApiKey": "sk-YOUR-KEY"

Get a key at: https://platform.openai.com/api-keys

Local LLM (Ollama — completely free, no API key)

"promptReviewer.aiProvider": "local"

Install Ollama at: https://ollama.com, then run ollama pull llama3

⌨️ Keyboard Shortcuts

⚙️ All Settings

Open settings with Ctrl+, and search promptReviewer:

💡 Common Workflows

Workflow 1 — Quick Check

1. Ctrl+N  →  type prompt  →  Ctrl+Shift+P  →  Analyze Prompt
2. See score in panel
3. Fix issues shown

Workflow 2 — Full Improvement

1. Type prompt in editor
2. Ctrl+Shift+P → Improve Prompt
3. Panel shows improved version
4. Click "Replace in Editor"
5. Copy improved prompt → paste into AI chat

Workflow 3 — Start from Template

1. Ctrl+Shift+P → Insert Template
2. Choose template (e.g. Bug Fix)
3. Fill in [PLACEHOLDERS]
4. Ctrl+Shift+P → Analyze Prompt
5. Score should be 70+

❓ Troubleshooting

"No active editor" error

Cause: You clicked the Prompt Reviewer panel before clicking Analyze, which unfocused the editor.

Fix: Click back inside your editor first, then press Ctrl+Shift+P → Analyze Prompt

Panel shows nothing after clicking Analyze

Fix: Press Ctrl+Shift+P → Developer: Reload Window, then try again.

Score is always 0

Cause: The editor file is empty.

Fix: Make sure you have typed your prompt text in the editor before analyzing.

Right-click menu does not show "Analyze Prompt"

Fix: You must select some text first (or use Ctrl+A to select all), then right-click.

📬 Support & Feedback

• Report a bug: GitHub Issues
• Marketplace page: VS Code Marketplace
• Open VSX (Windsurf): Open VSX Registry

📄 License

MIT — free to use, modify, and distribute.