# 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` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jlevy/pprose-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jlevy/pprose-review/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-17
- Page: https://skillmd.com/skills/jlevy/pprose-review

---

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

> 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

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