review-shepherd

Generates prioritized BUILD.md feedback from academic manuscript drafts and optional analysis/survey outputs.

4|1|Updated Jan 28, 2026

Search Tags:#feedback #review #academic-writing #review-analysis #manuscripts

Ready to run

npx skills add https://github.com/hisazumi/paper-review-skills --skill review-shepherd

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: review-shepherd
Source: https://github.com/hisazumi/paper-review-skills/tree/main/skills/review-shepherd
Command: npx skills add https://github.com/hisazumi/paper-review-skills --skill review-shepherd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transforms critical analysis into constructive, actionable feedback tailored for authors of academic manuscripts.

Core Features & Use Cases

Integrates critique with optional analysis and survey outputs to generate cohesive, prioritized recommendations.
Produces a unified REVIEW.md in the paper's directory, balancing rigorous critique with supportive guidance.
Supports using a base draft plus optional --analysis and --survey inputs; automatically handles merging intermediate outputs and cleaning up by default, with --keep-intermediate to retain them.

Quick Start

Use the skill with a draft file: review-shepherd path/to/paper-draft.md review-shepherd paper.tex --analysis analyze_output.md --survey survey_output.md review-shepherd thesis.docx --keep-intermediate

Frequently Asked Questions about review-shepherd

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

FAQPage Schema

How do I turn critical analysis into actionable feedback for academic manuscripts?▼

To turn critical analysis into actionable feedback, provide a draft file along with optional analysis and survey outputs. The tool merges these inputs and generates a unified REVIEW.md containing prioritized, concrete improvement suggestions tailored for academic authors.

What's the best way to consolidate multiple review analyses into a single document?▼

The best way to consolidate multiple review analyses is to pass your draft alongside optional --analysis and --survey files. The tool integrates these intermediate outputs into a cohesive REVIEW.md, balancing rigorous critique with supportive guidance in one location.

Can I use this with markdown, LaTeX, and Word draft files?▼

Yes, you can process markdown, LaTeX, and Word drafts by specifying the file path. The tool accepts formats like paper-draft.md, paper.tex, and thesis.docx, generating a REVIEW.md in the same directory.

How do I keep intermediate analysis files after generating a manuscript review?▼

To keep intermediate analysis files after generating a manuscript review, use the --keep-intermediate flag. By default, the tool cleans up these files, but this option retains them alongside the final REVIEW.md for further reference.

Does the tool require separate analysis files to review a manuscript?▼

No, the tool does not require separate analysis files to review a manuscript. You can run it with just a draft file, and it will generate a REVIEW.md, though providing optional --analysis and --survey inputs creates more comprehensive feedback.