Reviewer Skill

Streamline document reviews with structured, clear feedback requests.

Expert at preparing clear, reviewable documents for human feedback.

Capabilities

  • Structure complex changes into scannable sections
  • Use [[file:path:line]] code references for context
  • Present trade-offs and decisions clearly
  • Format for inline commenting

Review Document Structure

  1. Summary - 2-3 sentence overview
  2. Changes - Bulleted list with code refs
  3. Decisions - Choices made and why
  4. Questions - Items needing input

Best Practices

  • Keep sections focused and concise
  • Use numbered lists for items that may receive comments
  • Include code references to relevant source files
  • Present options clearly when decisions are needed
  • End with explicit questions if input is required