pr-review-toolkit
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
View on GitHubTable of content
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
Installation
npx claude-plugins install @anthropics/claude-plugins-official/pr-review-toolkit
Contents
Folders: agents, commands
Files: README.md
Documentation
A comprehensive collection of specialized agents for thorough pull request review, covering code comments, test coverage, error handling, type design, code quality, and code simplification.
Overview
This plugin bundles 6 expert review agents that each focus on a specific aspect of code quality. Use them individually for targeted reviews or together for comprehensive PR analysis.
Agents
1. comment-analyzer
Focus: Code comment accuracy and maintainability
Analyzes:
- Comment accuracy vs actual code
- Documentation completeness
- Comment rot and technical debt
- Misleading or outdated comments
When to use:
- After adding documentation
- Before finalizing PRs with comment changes
- When reviewing existing comments
Triggers:
"Check if the comments are accurate"
"Review the documentation I added"
"Analyze comments for technical debt"
2. pr-test-analyzer
Focus: Test coverage quality and completeness
Analyzes:
- Behavioral vs line coverage
- Critical gaps in test coverage
- Test quality and resilience
- Edge cases and error conditions
When to use:
- After creating a PR
- When adding new functionality
- To verify test thoroughness
Triggers:
"Check if the tests are thorough"
"Review test coverage for this PR"
"Are there any critical test gaps?"
3. silent-failure-hunter
Focus: Error handling and silent failures
Analyzes:
- Silent failures in catch blocks
- Inadequate error handling
- Inappropriate fallback behavior
- Missing error logging
When to use:
- After implementing error handling
- When reviewing try/catch blocks
- Before finalizing PRs with error handling
Triggers:
"Review the error handling"
"Check for silent failures"
"Analyze catch blocks in this PR"
4. type-design-analyzer
Focus: Type design quality and invariants
Analyzes:
- Type encapsulation (rated 1-10)
- Invariant expression (rated 1-10)
- Type usefulness (rated 1-10)
- Invariant enforcement (rated 1-10)
When to use:
- When introducing new types
- During PR creation with data models
- When refactoring type designs
Triggers:
"Review the UserAccount type design"
"Analyze type design in this PR"
"Check if this type has strong invariants"
5. code-reviewer
Focus: General code review for project guidelines
Analyzes:
- CLAUDE.md compliance
- Style violations
- Bug detection
- Code quality issues
When to use:
- After writing or modifying code
- Before committing changes
- Before creating pull requests
Triggers:
"Review my recent changes"
"Check if everything looks good"
"Review this code before I commit"
6. code-simplifier
Focus: Code simplification and refactoring
Analyzes:
- Code clarity and readability
- Unnecessary complexity and nesting
- Redundant code and abstractions
- Consistency with project standards
- Overly compact or clever code
When to use:
- After writing or modifying code
- After passing code review
- When code works but feels complex
Triggers:
"Simplify this code"
"Make this clearer"
"Refine this implementation"
Note: This agent preserves functionality while improving code structure and maintainability.
Usage Patterns
Individual Agent Usage
Simply ask questions that match an agent’s focus area, and Claude will automatically trigger the appropriate agent:
"Can you check if the tests cover all edge cases?"
→ Triggers pr-test-analyzer
"Review the error handling in the API client"
→ Triggers silent-failure-hunter
"I've added documentation - is it accurate?"
→ Triggers comment-analyzer
Comprehensive PR Review
For thorough PR review, ask for multiple aspects:
"I'm ready to create this PR. Please:
1. Review test coverage
2. Check for silent failures
3. Verify code comments are accurate
4. Review any new types
5. General code review"
This will trigger all relevant agents to analyze different aspects of your PR.
Proactive Review
Claude may proactively use these agents based on context:
- After writing code → code-reviewer
- After adding docs → comment-analyzer
- Before creating PR → Multiple agents as appropriate
- After adding types → type-design-analyzer
Installation
Install from your personal marketplace:
/plugins
# Find "pr-review-toolkit"
# Install
Or add manually to settings if needed.
Agent Details
Confidence Scoring
Agents provide confidence scores for their findings:
comment-analyzer: Identifies issues with high confidence in accuracy checks
pr-test-analyzer: Rates test gaps 1-10 (10 = critical, must add)
silent-failure-hunter: Flags severity of error handling issues
type-design-analyzer: Rates 4 dimensions on 1-10 scale
code-reviewer: Scores issues 0-100 (91-100 = critical)
code-simplifier: Identifies complexity and suggests simplifications
Output Formats
All agents provide structured, actionable output:
- Clear is
…(truncated)