help

Critic Plugin Help

Present the following information to the user in a clear, readable format.

Skills

Skill	Description
/critic:manuscript	Full manuscript review — Claude (with rejection pass), Codex, and Grok as primary reviewers, plus Grok adversarial. Cross-review, synthesis, save.
/critic:review <chapter>	Chapter-level review with four roles: analytical, immersive, structural, adversarial.
/critic:downstream <chapter>	Assess what breaks in later chapters after editing a chapter.
/critic:extract <chapter>	Extract facts from a chapter and diff against world state.
/critic:summarize	Generate summaries of all chapters into summary/.
/critic:consult <question>	Get a second opinion from Codex/Gemini/Grok on a specific question. Also used proactively by Claude when a second opinion would help.
/critic:rebuttal <issue-id>	Rebut or defer a review issue. Conversational — helps refine the response.
/critic:settings	View and update plugin settings.
/critic:help	This help text.

Configuration

Settings

Run /critic:settings to view or change settings. Settings persist across sessions.

/critic:settings                              — view all
/critic:settings vault_path /path/to/vault    — set vault path
/critic:settings claude_model claude-sonnet-4-6
/critic:settings codex_model gpt-5.3-codex
/critic:settings gemini_model gemini-2.5-flash
/critic:settings adversarial_base_url https://api.x.ai/v1
/critic:settings adversarial_model grok-3-mini
/critic:settings adversarial_api_key <key>
/critic:settings claude_enabled false         — disable a provider

All available settings:

Setting	Description
vault_path	Absolute path to your Obsidian vault
claude_enabled	Enable/disable Claude (true/false)
claude_model	Claude model name
anthropic_api_key	Anthropic API key (omit for system auth)
codex_enabled	Enable/disable Codex
codex_model	Codex model name
openai_api_key	OpenAI API key (omit for Codex CLI login)
gemini_enabled	Enable/disable Gemini
gemini_model	Gemini model name
adversarial_enabled	Enable/disable adversarial reviewer
adversarial_base_url	OAI-compatible API endpoint
adversarial_model	Model name for adversarial provider
adversarial_api_key	API key for adversarial provider

Settings can also be set in config.yaml in the plugin directory. Settings from /critic:settings override config.yaml.

Prompt Overrides

All reviewer prompts can be customized without rebuilding. Prompts are loaded from (in order):

1. <vault>/prompts/<name>.md — per-project override
2. <plugin>/prompts/<name>.md — plugin-level default
3. Compiled-in default — fallback built into the binary

To customize a prompt, copy it from the plugin's prompts/ directory to <vault>/prompts/ and edit. The server picks up the change on the next tool call.

Available prompt files:

File	Used by	Variables
agent-framing.md	All reviewers	None
verdict.md	All reviewers	None
review-base.md	Chapter review	{{.Role}}, {{.MaxIssues}}
review-analytical.md	Analytical reader role	None
review-immersive.md	Immersive reader role	None
review-structural.md	Structural analyst role	None
review-adversarial-role.md	Adversarial critic role	None
cross-review.md	Cross-review pass	{{.MaxNewIssues}}
synthesis.md	Synthesis	{{.ReviewNum}} (zero-padded to 3 digits)
manuscript.md	Manuscript review	None
rejection-pass.md	Claude's rejection pass	None
adversarial.md	Adversarial/Grok rejection	None
canon-extraction.md	Canon extraction	None
downstream.md	Downstream assessment	None

Variables use Go template syntax. {{.ReviewNum}} becomes e.g. 004.

Vault Structure

vault/
  story/           — one .md file per chapter (sorted alphabetically)
  world/           — world-building notes (optional, any structure)
  plot/            — plot outlines and arcs (optional)
  summary/         — chapter summaries (generated by /critic:summarize)
  review/          — saved reviews (numbered: 003-manuscript-critic-...)
  prompts/         — prompt overrides (optional)
  style.md         — style guide (optional, passed to all reviewers)
  issues.md        — deferred issues (optional, managed by /critic:rebuttal)

Review Files

Reviews are saved as NNN-prefix-timestamp.md with globally sequential numbering across all review types. Issues are numbered ISSUE-NNN-NN where NNN matches the review number.

Author rebuttals are added via /critic:rebuttal ISSUE-NNN-NN and appear as Obsidian callouts inline in the review file. Future reviewers see and respect rebuttals.

Deferred issues go to issues.md and are passed to manuscript reviewers with instructions to only re-raise if the issue has escalated.