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