# Pprose Review

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

- Skill: `jlevy/pprose-review-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jlevy/pprose-review-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jlevy/pprose-review-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: jlevy (https://skillmd.com/u/jlevy)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jlevy/pprose-review-2

---

<!-- DO NOT EDIT: generated by `pprose install` (format=f01) -->

> Run pprose as `pprose <command>` if on PATH, else `uvx pprose@0.1.0 <command>`
> (zero-install via uv).
> Run `pprose --help` for every command, `pprose skill --list` for the other Practical
> Prose skills, and `pprose shortcut --list` / `pprose guidelines --list` /
> `pprose runbook --list` for on-demand playbooks, style guides, and procedures.

# 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. 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).