| name | pprose-review |
| description | Review one practical document and report tiered editorial feedback (what a common edit, a copy edit, and a full substantive pass would each change) without modifying the document and without numeric scores. Read-only. Use when asked to review, critique, give feedback, or get an edit plan, and you do not want edits applied, a scored eval, or a version comparison. |
Run pprose as pprose <command> if on PATH, else uvx pprose@0.4.0 <command>
(zero-install via uv).
Run pprose --help for every command, pprose skill for the other Practical Prose
skills, and pprose list for all on-demand playbooks, style guides, and procedures
(pprose shortcut, pprose guidelines, pprose runbook each print one by name).
Review
This is a read-only skill: it never modifies the target document and assigns no
scores. It produces a single tiered editorial review side document that sorts every
finding into three layers of edit depth:
- Tier 1, common edit: formatting and structure fixes a
pprose-common-edit pass
would apply (the common documentation substrate).
- Tier 2, copy edit: Expression and Form fixes (E1-E3, F1-F3) a
pprose-copy-edit
pass would apply: language and formatting, no change of meaning.
- Tier 3, full feedback: the substantive Purpose, Reasoning, Grounding, and Judgment
issues that need author judgment: flagged, never silently rewritten.
Use it when the user wants feedback or an edit plan without touching the document.
For other intents, route elsewhere: to actually apply the edits use pprose-copy-edit
(Tiers 1-2) or pprose-full-edit (all tiers); for a scored 1-5 rubric use
pprose-eval; to compare document versions use pprose-compare.
Inputs
- Path to one Markdown document.
- Optional: audience, risk level, and a review brief.
- Optional output path for the review (default
<source-basename>.review.md).
Steps
- Run
pprose shortcut shortcut-review and follow it: run the audit passes, change
nothing, and sort each finding into Tier 1, Tier 2, or Tier 3.
- If the document is a comprehensive practical guide (a reference work helping readers
navigate a complex topic), also audit against
pprose guidelines writing-practical-guides (honoring each guideline’s applies-when
caveat) and sort its findings into the same tiers.
- Write the tiered review to the output path; make no edits to the source and assign no
scores.
Output
Return the review path, the count of findings per tier, and the recommended next action
(run pprose-copy-edit to apply Tiers 1-2 automatically; Tier 3 is for author
judgment).
