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).
1---2name: pprose-review3description: 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.4---5<!-- DO NOT EDIT: generated by `pprose install` (format=f02) -->67> Run pprose as `pprose <command>` if on PATH, else `uvx pprose@0.4.0 <command>`8> (zero-install via uv).9> Run `pprose --help` for every command, `pprose skill` for the other Practical Prose10> skills, and `pprose list` for all on-demand playbooks, style guides, and procedures11> (`pprose shortcut`, `pprose guidelines`, `pprose runbook` each print one by name).1213# Review1415This is a **read-only** skill: it never modifies the target document and assigns no16scores. It produces a single **tiered editorial review** side document that sorts every17finding into three layers of edit depth:1819- **Tier 1, common edit:** formatting and structure fixes a `pprose-common-edit` pass20 would apply (the common documentation substrate).21- **Tier 2, copy edit:** Expression and Form fixes (E1-E3, F1-F3) a `pprose-copy-edit`22 pass would apply: language and formatting, no change of meaning.23- **Tier 3, full feedback:** the substantive Purpose, Reasoning, Grounding, and Judgment24 issues that need author judgment: flagged, never silently rewritten.2526Use it when the user wants feedback or an edit plan **without** touching the document.27For other intents, route elsewhere: to actually apply the edits use `pprose-copy-edit`28(Tiers 1-2) or `pprose-full-edit` (all tiers); for a scored 1-5 rubric use29`pprose-eval`; to compare document versions use `pprose-compare`.3031## Inputs3233- Path to one Markdown document.34- Optional: audience, risk level, and a review brief.35- Optional output path for the review (default `<source-basename>.review.md`).3637## Steps38391. Run `pprose shortcut shortcut-review` and follow it: run the audit passes, change40 nothing, and sort each finding into Tier 1, Tier 2, or Tier 3.412. If the document is a comprehensive practical guide (a reference work helping readers42 navigate a complex topic), also audit against43 `pprose guidelines writing-practical-guides` (honoring each guideline’s applies-when44 caveat) and sort its findings into the same tiers.453. Write the tiered review to the output path; make no edits to the source and assign no46 scores.4748## Output4950Return the review path, the count of findings per tier, and the recommended next action51(run `pprose-copy-edit` to apply Tiers 1-2 automatically; Tier 3 is for author52judgment).