skills.rest
hisazumi
hisazumiCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/hisazumi/paper-review-skills --skill review-shepherd
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Education & Research Skills→
czh-ee-2023czh-ee-2023

paper-write

Convert structured outlines into LaTeX manuscripts for academic venues.

Community
Advanced
SunS1eep1ngSunS1eep1ng

manuscript-writing

Revise and review academic manuscripts for clarity and scientific rigor.

Community
Advanced
flowelflowel

scientify-write-review-paper

Guide literature review writing with structured reading, note organization, and academic writing templates.

Community
Advanced
christopherkennychristopherkenny
14

proofread

Identify and report prose quality issues in Quarto manuscripts without modifying the source.

Community
Intermediate