oedokumaci/gale-shapley-algorithm / .agents/skills/review
review
VerifiedReview code for issues, best practices, and improvements. Use when the user asks for a code review, wants feedback on their code, or asks you to check their implementation.
Review Skill
Perform code review focusing on quality, correctness, and maintainability.
Review Checklist
Correctness
- Logic errors or edge cases
- Error handling coverage
- Type safety and null checks
Code Quality (SOLID + Clean Code)
- Single Responsibility: One reason to change per class/function
- Open/Closed: Open for extension, closed for modification
- Liskov Substitution: Subtypes substitutable for base types
- Interface Segregation: Specific interfaces over general ones
- Dependency Inversion: Depend on abstractions
- DRY, YAGNI, meaningful names, Boy Scout Rule
- Functions: Small (<20 lines), do one thing, few args (0-2)
- No side effects, appropriate abstraction level
Style Compliance
- Type hints on all functions/methods
- Google-style docstrings
- Absolute imports only
- Line length under 120 chars
Testing
- Tests cover new functionality
- Tests verify behavior, not implementation
- Edge cases tested
- No flaky tests
Security
- No hardcoded secrets
- Input validation at boundaries
- Safe handling of user data
Process
- Read the code to understand its purpose
- Run through the review checklist
- Identify issues by category:
- Critical: Bugs, security issues
- Major: Design problems, missing tests
- Minor: Style, naming, documentation
- Provide actionable feedback with specific suggestions
- Note positive aspects of the code
Output Format
## Code Review
### Summary
Brief overview of the code's purpose and quality.
### Critical Issues
- Issue description and location
- Suggested fix
### Suggestions
- Improvement opportunities
- Alternative approaches
### Positive Notes
- Well-done aspects
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |