# Code Review

> Expert code review guidance for thorough and constructive feedback

- Skill: `portertech/code-review` (Agent Skill)
- Install (CLI): `npx skillmds@latest add portertech/code-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/portertech/code-review/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: portertech (https://skillmd.com/u/portertech)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/portertech/code-review

---


# 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