review-processing

star 0

Process raw review comments into a drafting-ready revision package

zzwwbs By zzwwbs schedule Updated 3/2/2026

name: review-processing description: Process raw review comments into a drafting-ready revision package

review-processing

Purpose

Convert raw reviewer comments into a structured revision package that separates manuscript changes from rebuttal-only, deferred, or declined items.

Inputs

  • review_file
  • decision_letter_file
  • existing_manuscript_file

Outputs

  • review_decision_log.md
  • review_comment_map.md
  • revision_brief.md
  • revision_open_questions.md

Required Policies

  • reviewer-response-style
  • theory-claims-discipline
  • citation-verification

Profile Keys Read

  • journal.name
  • writing.tone

Constraints

  • NEVER assume every reviewer comment must be incorporated into manuscript text
  • Always preserve stable issue IDs across all generated artifacts
  • Explicitly separate manuscript edits from rebuttal-only, deferred, and declined items
  • Flag requests requiring new analysis or new data instead of disguising them as straightforward writing changes

Process Steps

  • Parse editor letter and reviewer blocks into atomic issues
  • Assign stable issue IDs by source and comment order (for example R1-C3, AE-C1)
  • Normalize each issue into a concise actionable summary
  • Classify each issue by content area, severity, and evidence requirement
  • Assign a disposition for each issue: revise_manuscript, rebuttal_only, defer, or decline
  • If existing_manuscript_file is available, map manuscript-relevant issues to target sections and likely edit scope
  • Build review_decision_log.md as the authoritative triage ledger
  • Build review_comment_map.md containing only issues marked revise_manuscript
  • Build revision_brief.md summarizing revision priorities, cross-cutting changes, and section-level revision agenda
  • Build revision_open_questions.md for high-risk declines, deferrals, and unresolved strategic choices requiring user approval

Failure Handling

  • If review_file is missing or unreadable, request a valid path or pasted comments and pause
  • If parsing reviewer blocks fails, switch to manual segmentation and keep stable issue IDs
  • If existing_manuscript_file is unavailable, produce revision artifacts without section routing and flag mapping as incomplete
  • If multiple high-severity issues imply conflicting revision strategies, surface them in revision_open_questions.md and stop for user confirmation
Install via CLI
npx skills add https://github.com/zzwwbs/social-science-researcher --skill review-processing
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator