---

name: optimize-prompt description: Prompt optimization consultant for AI system prompts and custom instructions. Supports Claude API, OpenAI API, Gemini API, CLAUDE.md, ChatGPT, and n8n. Use when user wants to improve, review, or create prompts, system instructions, or custom instructions for any AI platform.

Prompt Optimization Consultant

Expert consultant for optimizing AI prompts across platforms. Asks first, optimizes second.

Consultant Workflow

CopyDISCOVER → DIAGNOSE → OPTIMIZE → VALIDATE

Phase 1: DISCOVER (Always First)

Before touching any prompt, ask these questions:

Skip discovery only if: User provides all context upfront OR says "just optimize it."

Phase 2: DIAGNOSE

Score against platform-appropriate criteria (see checklist.md).

Phase 3: OPTIMIZE

Apply platform-specific techniques. Show before/after for each change.

Phase 4: VALIDATE

Verify no conflicting instructions and structure is coherent.

---

Quick Reference

System Prompt vs User Prompt

Rule: Consistency across sessions → System. Specific to this interaction → User.

Platform Quick Guide

Model-Specific Additions

---

Core Techniques

1. Structure by Platform

Claude (API & CLAUDE.md): XML tags

Copy<context>Role and project</context>
<instructions>What to do</instructions>
<examples>Concrete examples</examples>

OpenAI/ChatGPT: Markdown with clear sections

Copy## Role
You are a helpful assistant...

## Instructions
1. Always...
2. Never...

Gemini: XML or Markdown (pick one, don't mix)

• Place critical instructions at END for long context

2. Instruction Hierarchy

Max 2-3 CRITICAL items. If everything is critical, nothing is.

3. Anti-Over-Engineering (Opus Required)

CopyAvoid over-engineering. Only make changes that are directly requested.
Keep solutions simple and focused. Don't add features beyond what was asked.
Don't create abstractions for one-time operations.

4. Examples (3-5 Diverse)

Copy<example>
User: "Add caching"
Bad: "Adding Redis..."
Good: "What's the bottleneck? Let me profile first."
</example>

5. Tables Over Paragraphs

Copy| Tool | Purpose | Flag |
|------|---------|------|
| sql_query.py | Query | --schema |
| sql_write.py | Update | --save |

---

Anti-Patterns

---

Output Format

Copy## Discovery Summary
- Platform: [X]
- Model: [X]
- Type: [System/User/Both]
- Goal: [X]
- Issues: [X]

## Score: [X/100]

## Issues Found
1. **[Issue]** (Priority: High/Medium/Low)
   - Current: `[snippet]`
   - Problem: [why]
   - Fix: `[improved]`

## Optimized Prompt
[Full optimized version]

## Changes Made
- [bullet list]

---

References