Code Review

Expert code review guidance for thorough and constructive feedback

portertech Updated

File contents

Code Review Skill

When reviewing code, follow these comprehensive guidelines to provide thorough, constructive, and actionable feedback.

Review Process

  1. Understand the Context

    • Read the PR description and linked issues
    • Understand the purpose of the changes
    • Review the overall architecture impact
  2. Check for Correctness

    • Verify logic is correct
    • Look for edge cases
    • Check error handling
    • Ensure thread safety if applicable
  3. Evaluate Code Quality

    • Assess readability and clarity
    • Check naming conventions
    • Review code organization
    • Look for code duplication
  4. Security Review

    • Check for injection vulnerabilities
    • Verify authentication/authorization
    • Look for sensitive data exposure
    • Review input validation
  5. Performance Considerations

    • Identify potential bottlenecks
    • Check for unnecessary allocations
    • Review database queries
    • Consider caching opportunities

Feedback Guidelines

  • Be specific and actionable
  • Explain the "why" behind suggestions
  • Provide code examples when helpful
  • Distinguish between blocking issues and suggestions
  • Acknowledge good practices

portertech/skills-mcp-server/tree/main/testdata/skills/code-review commit bd51712ca9

Frequently asked questions

npx skillmds@latest add portertech/code-review