Skip to content

aiskillstore/marketplace / skills/0xmsc/review-code

review-code

Verified

Provides a structured workflow for planning and executing code reviews like a senior engineer. Use when asked to review code, PRs, or plan a code review task.

FileKindSize
SKILL.mdskill md785 B
references/checklist.mdmarkdown4.3 KB
skill-report.jsonconfig9.8 KB

references/checklist.md

View on GitHub
# Code Review Checklist

A comprehensive checklist for senior engineer-level code reviews. Use this as a reference during the workflow.

## General
- [ ] **Purpose**: Does the change clearly address a requirement or fix a bug?
- [ ] **Scope**: Is the change focused? Avoids scope creep?
- [ ] **Testing**: Are there appropriate tests (unit, integration, e2e)?
- [ ] **Documentation**: Updated README, comments, API docs?

## Code Quality
- [ ] **Naming**: Variables, functions, classes are clear and consistent?
- [ ] **Readability**: Code is self-documenting? Complex logic explained?
- [ ] **Simplicity**: No over-engineering? Simplest solution that works?
- [ ] **Duplication**: No repeated code? Extract common patterns?
- [ ] **Magic numbers/strings**: Constants defined?
- [ ] **Comments**: Why, not what? No redundant comments?

## Design & Architecture
- [ ] **Single Responsibility**: Functions/classes do one thing?
- [ ] **Open/Closed Principle**: Open for extension, closed for modification?
- [ ] **Liskov Substitution**: Subtypes are substitutable?
- [ ] **Interface Segregation**: No fat interfaces?
- [ ] **Dependency Inversion**: Depend on abstractions, not concretions?
- [ ] **Design patterns**: Used appropriately? Not forced?
- [ ] **Coupling**: Low coupling between modules?
- [ ] **Cohesion**: High cohesion within modules?

## Security
- [ ] **Input Validation**: All external input validated?
- [ ] **Output Encoding**: Prevents XSS? SQL injection?
- [ ] **Authentication**: Proper auth checks? Not bypassable?
- [ ] **Authorization**: Role-based access control?
- [ ] **Secrets**: No hardcoded credentials? Uses secrets management?
- [ ] **Cryptographic practices**: Secure algorithms? Proper key management?
- [ ] **Error messages**: No sensitive info leaked?
- [ ] **Dependency scanning**: No known vulnerabilities?

## Performance
- [ ] **Time Complexity**: Acceptable for expected load?
- [ ] **Space Complexity**: Memory usage reasonable?
- [ ] **Database**: N+1 queries? Missing indexes? Proper transactions?
- [ ] **Caching**: Used appropriately? Invalidation strategy?
- [ ] **Network calls**: Batched? Timeouts? Retry logic?
- [ ] **Async/await**: Used where blocking would be problematic?

## Error Handling & Logging
- [ ] **Exceptions**: Caught appropriately? Not swallowed?
- [ ] **Error messages**: Informative for debugging?
- [ ] **Logging**: Sufficient level (debug, info, error)?
- [ ] **Structured logging**: For log parsing?
- [ ] **Graceful degradation**: System remains stable on failure?

## Maintainability
- [ ] **Consistency**: Follows project style guide? (linting)
- [ ] **Configurability**: Hardcoded values replaced with config?
- [ ] **Modularity**: Components can be replaced/updated?
- [ ] **Tech debt**: Acknowledged? Ticketed?
- [ ] **Backward compatibility**: Breaking changes documented?

## Testing
- [ ] **Unit tests**: Cover main logic? Edge cases?
- [ ] **Integration tests**: Cover interactions?
- [ ] **Test readability**: Tests are clear? Given/When/Then?
- [ ] **Mocking**: Proper mocking? Not over-mocked?
- [ ] **Test isolation**: No shared state between tests?

## Version Control
- [ ] **Commits**: Atomic? Meaningful messages?
- [ ] **Branch**: Up to date with main? Rebased?
- [ ] **Merge commits**: Avoided? (prefer rebase)
- [ ] **Conflicts**: Resolved correctly?

## Platform/Infrastructure
- [ ] **Environment variables**: Documented? Required defaults?
- [ ] **Docker/Container**: Builds? Optimized?
- [ ] **CI/CD**: Pipeline passes? All steps needed?
- [ ] **Monitoring**: New metrics/alerts added?
- [ ] **Rollback plan**: Exists? Tested?

## Reviewer Notes
- [ ] **Overall assessment**: Approve, request changes, or comment?
- [ ] **Priority**: Critical, major, minor, nit?
- [ ] **Suggestions**: Provide alternatives? Link to docs?
- [ ] **Positive feedback**: Acknowledge good practices?

## Tools to Run
- Linting tools (e.g., `just lint`, `eslint`, `flake8`)
- Test runners (e.g., `just test`, `npm test`, `pytest`)
- Security scanners (e.g., `npm audit`, `safety check`, `bandit`, `semgrep`)
- `git diff` to double-check changes

## Common Pitfalls
- **Over-commenting**: Commenting obvious code
- **Under-testing**: Missing edge cases
- **Premature optimization**: Optimizing before measuring
- **Inconsistent style**: Mixing tabs/spaces, etc.
- **Ignoring warnings**: Linter warnings are there for a reason
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall