About code-review
A code-review skill for developers and coding agents to check implemented changes before delivery. It combines a checklist for correctness, quality, tests, and safety with a defined review process and helper lint script.
Key features
- 01Correctness and edge-case checklist
- 02Code quality review
- 03Test coverage and execution steps
- 04Security and input-safety checks
- 05Bundled Python lint script
Use cases
- 01Reviewing changes before delivery
- 02Checking test coverage and failure cases
- 03Scanning Python code for common lint issues
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ langchain-ai/ deepagents --skill code-reviewAfter installing, type/code-reviewin Claude Code to confirm it loaded.
Bundled fileslint_check.py
Details
From the project READMECode Review Skill
Use this skill after implementing changes to validate your work before delivering.
Review Checklist
1. Correctness
- Changes solve the original issue/task
- No unintended side effects on existing functionality
- Edge cases are handled
- Error handling is appropriate (not excessive)
2. Code Quality
- Code matches existing style and patterns
- No unnecessary complexity or abstraction
- Variable and function names are clear
- No dead code, commented-out code, or TODOs left behind
3. Tests
- New functionality has test coverage
- Existing tests still pass
- Tests cover both happy path and error cases
- Tests are not brittle (don't test implementation details)
4. Safety
- No hardcoded secrets or credentials
- User input is validated at boundaries
- No SQL injection, XSS, or command injection vectors
- File operations use safe paths
Process
- Read each modified file end-to-end (not just the diff)
- Run the test suite:
execute("python -m pytest -v") - Run linters if available:
execute("ruff check .") - Run the bundled lint check:
execute("python /skills/code-review/lint_check.py .") - Check against each item in the review checklist
- If any issues found, fix them and re-review
- When everything passes, the review is complete
Helper Scripts
/skills/code-review/lint_check.py— Scans Python files for missing docstrings, long functions (>50 lines), and bareexcept:clauses. Run it viaexecute("python /skills/code-review/lint_check.py [path ...]").
Comments
Markdown supported