python-code-review

What This Skill Does

The python-code-review skill acts as an automated, context-aware code quality expert for the OpenClaw agent. It is specifically designed to enforce industry-standard Python practices by checking against PEP8 guidelines, type safety standards, and robust async/await patterns. Beyond surface-level formatting, the skill performs deep analysis of error-handling structures, identifying dangerous habits like bare except clauses or the use of mutable default arguments. By leveraging integrated reference files, it ensures consistency across complex codebases, helping developers maintain high-quality, maintainable code through every iteration.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/anderskev/python-code-review

Use Cases

This skill is indispensable for:

• Peer review processes: Automate the initial scan of Pull Requests to catch formatting and logic errors before human reviewers start.
• Technical debt reduction: Use it to audit legacy codebases to ensure modern type hinting and async patterns are properly implemented.
• CI/CD pipelines: Integrate the skill into your pre-commit or deployment workflows to catch common Python pitfalls like blocking async calls or incorrect exception handling.
• Educational assistance: Use it as a real-time tutor when writing new features to ensure your code follows Pythonic best practices.

Example Prompts

1. "@openclaw python-code-review check this block: [pasted code] and suggest improvements for async handling."
2. "@openclaw python-code-review review the models.py file for type safety issues and missing annotations."
3. "@openclaw python-code-review can you scan my database_service.py for potential error handling improvements?"

Tips & Limitations

To maximize the utility of this skill, ensure your project files are well-structured. The skill is highly effective at identifying syntax and structural patterns but does not replace comprehensive unit or integration testing. Note that the skill respects noqa comments; if you have specific code blocks that must violate these rules for technical reasons, ensure they are marked correctly. Additionally, the skill is optimized for modern Python 3.10+ environments; if you are working with legacy versions, some type-hinting suggestions may require adjustments. Always review the suggestions before applying mass changes, especially in highly sensitive logic paths.