Peer Review Specialist
Deliver rigorous peer reviews with structured feedback and actionable insights
What You Can Do
This skill provides a comprehensive framework for conducting structured peer reviews that balance technical rigor with constructive feedback. It systematically evaluates code quality, architecture decisions, testing, security, and documentation while delivering specific, prioritized recommendations. You'll ensure consistent, professional review standards across your team and help developers grow through clear, actionable guidance.
Features
Examines functionality, code quality, design patterns, performance, security, testing, and documentation in a structured sequence
Combines technical rigor with constructive guidance, highlighting strengths before addressing areas for improvement
Categorizes issues as critical, major, minor, or style to help prioritize fixes and guide implementation urgency
Transforms observations into specific, implementable improvements with code examples and rationale when applicable
Assesses test coverage, test quality, edge case handling, and verification strategies for implementation
Identifies potential vulnerabilities, unsafe patterns, and violations of security best practices
Evaluates code comments, type hints, docstrings, function documentation, and architectural notes
Examines computational complexity, resource usage, and optimization opportunities relevant to context
Example Output
Peer Review: UserAuthenticationService
Summary
Solid implementation of JWT-based authentication with good error handling. Code is well-structured and documented. Primary opportunities: strengthen password validation, add rate limiting, and expand unit test coverage.
Strengths
✓ Clean separation of concerns — Token generation, validation, and refresh logic are properly isolated ✓ Comprehensive error handling — Specific error messages for debugging without exposing sensitive info ✓ Good inline documentation — Comments explain complex token claims and validation logic
Critical Issues (must address before merge)
- Missing rate limiting on login endpoint — Vulnerable to brute force attacks. Recommend: Redis-backed rate limiter (e.g.,
express-rate-limit)
Major Issues
- Password validation could be stronger — Currently requires 8 chars; consider NIST guidelines (min 12, no composition rules)
- Test coverage at 62% — Should reach 80%+ for security-critical code
Recommendations
- Implement exponential backoff rate limiting on
/auth/login - Upgrade password validation to follow NIST 800-63B guidelines
- Add integration tests for token refresh flow with expired tokens
- Document token claim structure in README
Testing & Coverage
- Current: 62% | Target: 80%+
- Missing: Edge cases around token expiry, concurrent refresh requests
- Good: Error path coverage, null input handling
Ready to merge? No — requires critical issues fixed first
What's Included
- Review framework template: Pre-built structure guiding you through systematic evaluation: Summary, Strengths, Issues, Recommendations, Testing, Security
- Severity classification guide: Clear definitions for critical, major, minor, and style issues with examples to calibrate your assessment
- Feedback patterns library: Pre-written constructive communication patterns for common issues (inconsistent naming, missing tests, etc.)
- Multi-layer evaluation checklist: Comprehensive checklist covering code quality, architecture, testing, security, documentation, and performance
- Example reviews: Full-length peer review examples showing proper structure, tone, and recommendation specificity across different domains
Who It's For
- Software engineers and developers
- Team leads and engineering managers
- Open source maintainers
- Senior architects and tech leads
- QA and code quality specialists
Best For
- Code reviews for feature pull requests
- Architecture and design pattern evaluation
- Security and performance audits
- Mentoring and learning-oriented feedback
- Refactoring and technical debt reviews
You might also like
Streamline your systematic reviews by using Claude to screen abstracts against inclusion criteria, extract structured data from full texts, and synthesize findings across studies. Reduce manual screening time by 60-80% while maintaining rigorous documentation of your review methodology. Claude becomes your collaborative partner throughout the entire evidence synthesis workflow, from protocol planning to final data synthesis.
Create professional banners, design systems, and brand-compliant content across multiple platforms. This comprehensive skill suite provides design intelligence for building UI/UX with systematic token architecture, component specifications, visual identity management, and AI-powered creative asset generation. Perfect for designing branded experiences with consistency, speed, and professional quality.
You receive a detailed systematic audit of your IRB protocol against federal regulations, institutional policies, and ethical standards. The skill identifies specific compliance gaps, maps findings to regulatory citations, and generates documented recommendations for remediation. You get a structured compliance assessment that pinpoints risk areas before submission or inspection.
You can rapidly analyze multiple research papers, extract quality metrics using evidence hierarchy frameworks, and generate structured literature syntheses. Claude evaluates study design, sample sizes, bias risk, and statistical significance to produce clinically actionable summaries that support evidence-based decision-making for healthcare providers and researchers.
You can streamline the entire editorial process by automating peer review coordination, synthesizing reviewer feedback into coherent editorial decisions, and generating professional correspondence at scale. The skill helps you manage manuscript timelines, track reviewer assignments, and produce consistent decision documents that maintain your journal's professional standards while saving hours of editorial work.
You'll master the librarian's approach to research by learning how to conduct structured reference interviews that clarify your exact information needs. This skill helps you design comprehensive, multi-database search strategies tailored to your research question, including optimized Boolean search strings, database selection logic, and source evaluation frameworks that ensure you find the most relevant academic sources efficiently.
This skill analyzes your academic manuscript and journal submission metadata against indexing standards from major databases (PubMed, Scopus, Web of Science, DOAJ). It identifies compliance gaps, recommends metadata improvements, optimizes keywords for discoverability, and validates citation formatting—helping your research reach the right audience and meeting publisher requirements on first submission.
This skill systematically reviews your research proposal against funder requirements, institutional policies, and compliance checkpoints to identify issues before submission. It validates proposal structure, budget justifications, and timelines while flagging common violations that could trigger desk rejections or revision requests. You'll receive a detailed compliance report with specific issues, severity levels, and actionable remediation steps for each funder type.