claude-orator

Orator Plugin

Prompt optimization. Scores prompts across 7 dimensions and restructures them using 8 Anthropic techniques. Deterministic — no LLM calls, no network, in-memory only.

Hooks

| Hook | When | Action | |------|------|--------| | PreToolUse(Task) | Subagent prompt lacks structure | Suggests orator_optimize before dispatching |

Token cost: 0 on well-structured prompts (XML tags, markdown headers, action verbs). ~50-80 on vague prompts. Never blocks — suggestion only.

Commands

| Command | Description | |---------|-------------| | /reprompt-orator <prompt> | Optimize a prompt using Anthropic best practices |

Workflows

Optimize (standalone)

1. /reprompt-orator "your prompt here" or call orator_optimize(prompt: "...")
2. Review score breakdown (7 dimensions, 1-10 each)
3. Use the restructured prompt with applied techniques

Optimize (with siblings)

1. If historian active: search_conversations("prompt optimization") to find past well-scored prompts
2. orator_optimize(prompt: "...") — score and restructure
3. If praetorian active: save_context(type: "decisions", ...) to preserve the optimized prompt rationale
4. If gladiator active: observe(summary: "xml-tags improved code prompts by +3.2") to track what works

Batch review

1. Review subagent prompts across a session
2. orator_optimize on each under-specified prompt
3. If vigil active: vigil_save("before-rewrite") before applying changes
4. Apply restructured prompts

Sibling Synergy

| Sibling | Value | How | |---------|-------|-----| | Historian | Past well-scored prompts as examples | search_conversations("prompt patterns") finds effective prompts from history | | Praetorian | Preserve optimization rationale | Compact optimized prompts and their scores for future reference | | Gladiator | Track what techniques work best | observe() records which techniques improve scores most | | Oracle | Find prompt engineering tools | search("prompt patterns") discovers relevant community tools | | Vigil | Checkpoint before batch rewrites | vigil_save() before applying optimized prompts across files |

MCP Tools Reference

| Tool | Purpose | |------|---------| | orator_optimize | Score prompt across 7 dimensions, apply techniques, return restructured version |

Scoring Dimensions

Clarity · Specificity · Structure · Context · Examples · Constraints · Tone (each 1-10)

Techniques

System prompts · XML tags · Chain of thought · Few-shot · Prefill · Long context · Extended thinking · Tool use

Storage

In-memory only. Zero disk storage. No databases, no external services.

Requires

claude mcp add orator -- npx claude-orator-mcp