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
Provide comprehensive research guidance to library patrons by creating customized search strategies, evaluating information sources, and developing literacy materials. You can conduct consultations, design reference guides, and help patrons navigate complex research questions across any subject area.
This skill analyzes grant requirements, interprets funder regulations, and coordinates compliance workflows for research institutions. You'll receive structured compliance guidance, multi-funder requirement synthesis, deadline tracking, and risk assessments that help you navigate complex sponsored research administration with confidence.
You can manage the complete subcontract lifecycle—from initial negotiation through execution, compliance monitoring, and closure—with built-in risk analysis and automated documentation. The skill verifies compliance requirements, identifies contractual risks, generates required documentation, and tracks key milestones and renewal dates. All workflows are customizable to your organization's procurement policies and risk tolerance.
This skill helps you manage sponsored research compliance requirements, generate required documentation, and track regulatory obligations. You can create compliance checklists, audit existing documentation against funder requirements, generate compliance reports, and maintain organized records of all sponsored program activities.
This skill helps you create standardized metadata schemas, auto-document datasets with rich descriptions, and generate structured data dictionaries that make your datasets discoverable and reusable. You can transform unorganized data into professionally documented datasets with consistent naming conventions, data lineage tracking, and compliance-ready documentation.
Streamline your editorial workflow by automatically synthesizing peer review feedback into actionable quality assessments. This skill transforms multiple reviewer comments into structured evaluation reports with recommendations for accept, revise, or reject decisions. You'll save hours consolidating reviews and make more consistent, defensible editorial choices backed by consistent quality criteria.
You can conduct comprehensive, systematic compliance audits for grants and contracts by analyzing documents against regulatory requirements, categorizing risks by severity, and documenting findings with supporting evidence. The skill generates detailed audit reports, regulatory gap analyses, and remediation roadmaps tailored to your specific compliance framework (FAR, OMB circulars, funder requirements, etc.). It accelerates audit cycles by automating finding documentation, comparative compliance mapping, and risk prioritization.
Design comprehensive brand identity systems from scratch, including logos in 55+ styles, corporate identity programs with 50+ deliverables, design tokens and UI styling frameworks, professional banners in 22+ styles, custom SVG icons, and optimized social media assets across 8+ platforms. Claude generates production-ready files with mockups, specifications, and platform-specific formatting for immediate use.