scientific-skills/peer-review/SKILL.md
Peer review is a systematic process for evaluating scientific manuscripts. Assess methodology, statistics, design, reproducibility, ethics, and reporting standards. Apply this skill for manuscript and grant review across disciplines with constructive, rigorous evaluation.
This skill should be used when:
When creating documents with this skill, always consider adding scientific diagrams and schematics to enhance visual communication.
If your document does not already contain schematics or diagrams:
For new documents: Scientific schematics should be generated by default to visually represent key concepts, workflows, architectures, or relationships described in the text.
How to generate schematics:
python scripts/generate_schematic.py "your diagram description" -o figures/output.png
The AI will automatically:
When to add schematics:
For detailed guidance on creating schematics, refer to the scientific-schematics skill documentation.
Conduct peer review systematically through the following stages, adapting depth and focus based on the manuscript type and discipline.
Begin with a high-level evaluation to determine the manuscript's scope, novelty, and overall quality.
Key Questions:
Output: Brief summary (2-3 sentences) capturing the manuscript's essence and initial impression.
Conduct a thorough evaluation of each manuscript section, documenting specific concerns and strengths.
Critical elements to verify:
Common issues to identify:
Red flags:
Evaluate the technical quality and rigor of the research with particular attention to common pitfalls.
Statistical Assessment:
Experimental Design:
Computational/Bioinformatics:
Assess whether the research meets modern standards for reproducibility and open science.
Data Availability:
Code and Materials:
Reporting Standards:
references/reporting_standards.md for common guidelinesEvaluate the quality, clarity, and integrity of data visualization.
Quality Checks:
Integrity Checks:
Clarity:
Verify that the research meets ethical standards and guidelines.
Human Subjects:
Animal Research:
Research Integrity:
Assess the manuscript's clarity, organization, and accessibility.
Structure and Organization:
Writing Quality:
Accessibility:
Organize feedback in a hierarchical structure that prioritizes issues and provides actionable guidance.
Provide a concise overall assessment (1-2 paragraphs):
List critical issues that significantly impact the manuscript's validity, interpretability, or significance. Number these sequentially for easy reference.
Major comments typically include:
For each major comment:
List less critical issues that would improve clarity, completeness, or presentation. Number these sequentially.
Minor comments typically include:
For each minor comment:
For manuscripts requiring detailed feedback, provide section-specific or line-by-line comments:
List specific questions that need clarification:
Maintain a constructive, professional, and collegial tone throughout the review.
Best Practices:
Avoid:
⚠️ CRITICAL: For presentations, NEVER read the PDF directly. ALWAYS convert to images first.
When reviewing scientific presentations (PowerPoint, Beamer, slide decks):
NEVER attempt to read presentation PDFs directly - this causes buffer overflow errors and doesn't show visual formatting issues.
Required Process:
python skills/scientific-slides/scripts/pdf_to_images.py presentation.pdf review/slide --dpi 150
# Creates: review/slide-001.jpg, review/slide-002.jpg, etc.
Print when starting review:
[HH:MM:SS] PEER REVIEW: Presentation detected - converting to images for review
[HH:MM:SS] PDF REVIEW: NEVER reading PDF directly - using image-based inspection
Visual Design and Readability:
Layout and Formatting (Check EVERY Slide Image):
Content Quality:
Structure and Flow:
Scientific Content:
Common Presentation Issues to Flag:
Critical Issues (Must Fix):
Major Issues (Should Fix):
Minor Issues (Suggestions for Improvement):
Summary Statement:
Layout and Formatting Issues (By Slide Number):
Slide 3: Text overflow - bullet point 4 extends beyond right margin
Slide 7: Element overlap - figure overlaps with caption text
Slide 12: Font size - axis labels too small to read from distance
Slide 18: Alignment - title not centered
Content and Structure Feedback:
Design and Accessibility:
Timing and Scope:
[14:30:00] PEER REVIEW: Starting review of presentation
[14:30:05] PEER REVIEW: Presentation detected - converting to images
[14:30:10] PDF REVIEW: Running pdf_to_images.py on presentation.pdf
[14:30:15] PDF REVIEW: Converted 25 slides to images in review/ directory
[14:30:20] PDF REVIEW: Inspecting slide 1/25 - title slide
[14:30:25] PDF REVIEW: Inspecting slide 2/25 - introduction
...
[14:35:40] PDF REVIEW: Inspecting slide 25/25 - acknowledgments
[14:35:45] PDF REVIEW: Completed image-based review
[14:35:50] PEER REVIEW: Found 8 layout issues, 3 content issues
[14:35:55] PEER REVIEW: Generating structured feedback by slide number
Remember: For presentations, the visual inspection via images is MANDATORY. Never attempt to read presentation PDFs as text - it will fail and miss all visual formatting issues.
This skill includes reference materials to support comprehensive peer review:
Guidelines for major reporting standards across disciplines (CONSORT, PRISMA, ARRIVE, MIAME, STROBE, etc.) to evaluate completeness of methods and results reporting.
Catalog of frequent methodological and statistical issues encountered in peer review, with guidance on identifying and addressing them.
Before finalizing the review, verify: