review-for-reader

Rewrite diff-anchored prose in comments and docs to current-state phrasing.

11|Updated Sep 5, 2025
One-click install
npx skills add https://github.com/thrawn01/claude-dotfiles --skill review-for-reader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-for-reader
Source: https://github.com/thrawn01/claude-dotfiles/tree/main/skills/review-for-reader
Command: npx skills add https://github.com/thrawn01/claude-dotfiles --skill review-for-reader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review a change from the perspective of the next maintainer who never saw the diff — catching comments, docstrings, and docs that only make sense to someone holding the diff ("diff-anchored writing"), stale comments referencing removed code, journal/history comments, what-not-why comments, and README/doc drift. Then rewrite the flagged prose to current-state phrasing in place.

Core Features & Use Cases

  • Diff-anchored prose detection and rewriting to remove temporal framing so future readers understand the change without needing the historical context.
  • Focuses on prose: comments, docstrings, README/docs, and PR descriptions; not on code logic.
  • Uses a fresh-context reviewer paradigm to surface and rewrite only the durable rationale while preserving concrete values and intent.

Quick Start

Review a change from the perspective of a future maintainer and rewrite diff-anchored prose to current-state phrasing.

Frequently Asked Questions about review-for-reader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rewrite diff-anchored comments to make sense without historical context?

To pass the Stranger Test, review comments and docstrings as if you never saw the diff, then rewrite journal-style narration or stale references into self-contained, current-state phrasing that retains concrete values and intent.

What is diff-anchored writing in code documentation and why is it a problem?

Diff-anchored writing is prose in comments or docs that only makes sense to someone holding the diff, referencing removed code or temporal changes. It creates stale documentation that fails to explain the current state to future maintainers who lack historical context.

How do I review a PR for documentation drift and stale comments?

Review a PR for stale comments by applying a fresh-context reviewer paradigm that surfaces references to removed code, journal-style history, and what-not-why explanations, then rewriting the flagged prose to current-state phrasing while preserving durable rationale.

Does this prose review approach check code logic or just documentation?

This prose review approach focuses exclusively on documentation, comments, docstrings, README files, and PR descriptions. It does not evaluate code logic, instead targeting diff-anchored writing and stale references to ensure explanations remain meaningful without historical context.

When should I not use diff-anchored prose rewriting for my project?

Avoid diff-anchored prose rewriting when you need to review code logic, enforce architectural patterns, or validate functional behavior. This approach targets only temporal framing and stale references in documentation, preserving concrete values rather than assessing runtime correctness.