pr-review-viewer

A single-file, zero-dependency browser viewer for *_review.md files produced by the summarize-pr skill, plus the linter and fixtures that define the pr-review/v1 markdown format.

See SPEC.md for the format contract and PLAN.md for the phased implementation plan. Agents working on this repo: read AGENTS.md first.

Install

npm install
npx playwright install

Playwright is the only dev dependency. The viewer itself has zero runtime dependencies.

Test

npm test               # full suite across chromium, firefox, webkit
npm run test:chromium  # local dev loop (chromium only)
npm run test:ui        # Playwright UI mode
npm run lint:fixtures  # run the markdown linter against tests/fixtures/*.md

Install

scripts/install.sh (added in Phase 18) is the only file in this repo that writes outside the project root. It publishes the in-repo skill/ tree (added in Phase 19) plus viewer.html to ~/.claude/skills/summarize-pr/, and refuses to run unless npm test is green. The install destination is never edited directly — see AGENTS.md § 1 "Project root is self-contained".

Format reference

The pr-review/v1 markdown format is defined in SPEC.md. The Python linter at scripts/lint_review_md.py (added in Phase 1) is the executable mirror of that spec.