code-review

Code review a pull request

Use this agent when code has been written or modified and needs to be simplified for clarity, consistency, and maintainability while preserving all functionality. This agent is typically suggested after a code review passes with no critical issues. It simplifies code by following project best practices while retaining all functionality. <example> Context: The code review completed with no CRITICAL or HIGH issues. assistant: "The code review found no critical issues. Would you like me to run the code-simplifier agent to improve clarity and maintainability?" user: "Yes, please simplify the code" assistant: "I'll use the code-simplifier agent to refine this implementation for better clarity." <commentary> After a successful code review, offer to run code-simplifier for polish. </commentary> </example> <example> Context: The user explicitly asks for code simplification. user: "Can you simplify this code and make it more readable?" assistant: "I'll use the code-simplifier agent to enhance clarity while preserving functionality." <commentary> User explicitly requested simplification. </commentary> </example> <example> Context: Complex code was just written that could benefit from cleanup. user: "I've implemented the feature but it feels messy" assistant: "Let me use the code-simplifier agent to clean up the implementation while keeping all functionality intact." <commentary> User indicated the code needs cleanup. </commentary> </example>

Use this agent when you need to analyze code comments for accuracy, completeness, and long-term maintainability. This includes: (1) After generating large documentation comments or docstrings, (2) Before finalizing a pull request that adds or modifies comments, (3) When reviewing existing comments for potential technical debt or comment rot, (4) When you need to verify that comments accurately reflect the code they describe. <example> Context: The user is working on a pull request that adds several documentation comments to functions. user: "I've added documentation to these functions. Can you check if the comments are accurate?" assistant: "I'll use the comment-analyzer agent to thoroughly review all the comments in this pull request for accuracy and completeness." <commentary> Since the user has added documentation comments and wants them checked, use the comment-analyzer agent to verify their accuracy against the actual code. </commentary> </example> <example> Context: The user just asked to generate comprehensive documentation for a complex function. user: "Add detailed documentation for this authentication handler function" assistant: "I've added the documentation. Now let me use the comment-analyzer agent to verify that the comments are accurate and helpful for long-term maintenance." <commentary> After generating large documentation comments, proactively use the comment-analyzer to ensure quality. </commentary> </example> <example> Context: The user is preparing to create a pull request with multiple code changes and comments. user: "I think we're ready to create the PR now" assistant: "Before creating the pull request, let me use the comment-analyzer agent to review all the comments we've added or modified to ensure they're accurate and won't create technical debt." <commentary> Before finalizing a PR, use the comment-analyzer to review all comment changes. </commentary> </example>

Analyzes PR test coverage quality, identifying critical gaps in behavioral coverage, edge cases, and error handling tests. Triggered automatically when test files are modified.

Analyzes PR changes for silent failures, inadequate error handling, empty catch blocks, and inappropriate fallback behavior. Triggered automatically when error handling code is modified.

Analyzes new types/interfaces/classes in a PR for encapsulation quality, invariant expression, and design best practices. Triggered automatically when new types are introduced.

This skill should be used when the user asks to "review a pull request", "code review this PR", "check this PR for bugs", "review PR