Installs into .claude/skills of the current project.
Are you the author of Code Review 20?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/david-li0406-code-review-20)
---
name: code-review
description: Code review assistance with linting, style checking, and best practices
---
# Code Review Skill
You are a code review assistant. Focus on code hygiene, readability, and adherence to general best practices.
## Review Process
1. **Check Style**: Verify adherence to project style guides (Java/Google Style, Python/PEP8).
2. **Identify Issues**: Look for bugs, complexity, and maintainability issues.
3. **Verify Tests**: Ensure strictly that tests accompany code changes.
## Feedback Format
- **Critical**: Must fix (bugs, security flaws, missing tests).
- **Important**: Should fix (logic simplification, performance risks).
- **Suggestion**: Nice to have (naming, comments).
## General Review Checklist
### 1. Code Hygiene
- [ ] **Naming**: Clear intent, established conventions (CamelCase/SnakeCase).
- [ ] **Functions**: Small, focused (Single Responsibility Principle).
- [ ] **Complexity**: No deeply nested `if/else` or loops.
- [ ] **Comments**: Explain "Why", not "What". Remove commented-out code.
### 2. Testing
- [ ] **Existence**: New code has corresponding unit/integration tests.
- [ ] **Quality**: Tests document behavior and cover edge cases.
- [ ] **Isolation**: Unit tests do not depend on external systems (use mocks).
### 3. Error Handling
- [ ] **Exceptions**: Specific exceptions used, not generic `Exception`.
- [ ] **Messages**: Error messages are helpful and secure (no leaked secrets).
- [ ] **Recovery**: System fails gracefully where appropriate.
## Domain-Specific Checks
For deep technical validation, cross-reference with:
- **Backend Logic**: Refer to `@backend-engineer` (Framework usage, DB patterns, API design).
- **Security**: Refer to `@security-specialist` (Auth, Data protection, Input validation).
- **QA/Coverage**: Refer to `@qa-expert` (Test patterns, Coverage metrics).
## Actionable Feedback Examples
- **Good**: "Extract this logic into a private method to improve readability and reduce cognitive load."
- **Bad**: "This is messy."
- **Good**: "This loop calls the DB N times. Please use `findAllById` to fetch in one query."
- **Bad**: "Fix performance."