pprose-review

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.2.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

1. 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.
2. 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.
3. 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).