claude-orator

// Prompt rhetoric coach — deterministic scoring and restructuring using Anthropic best practices

$ git log --oneline --stat

stars:290

forks:55

updated:February 22, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

nameclaude-orator

descriptionPrompt rhetoric coach — deterministic scoring and restructuring using Anthropic best practices

triggersPreToolUse

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)

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

Optimize (with siblings)

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

Batch review

Review subagent prompts across a session
orator_optimize on each under-specified prompt
If vigil active: vigil_save("before-rewrite") before applying changes
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