python-doctor - Python Code Audit and Health Check
Audits Python codebases for security, performance, correctness, and architecture issues with runtime checks and static analysis
Tags
Updated: 2026-05-28Capabilities
Typical Inputs
Typical Outputs
What this skill does
- scan Python codebase
- check syntax with compileall
- run pytest tests
- execute ruff lint
- run mypy type checks
- apply static rule scans
- calculate health score
- generate audit report
- identify security issues
- detect performance problems
- find correctness errors
- analyze architecture patterns
- suggest code fixes
Inputs
- Python project root directory
- Python runner command
- user execution approval
Outputs
- markdown audit report
- 0-100 health score
- security findings
- performance findings
- correctness findings
- architecture findings
- remediation recommendations
Requirements
- Python project access
- code execution capability
- pytest (optional)
- ruff (optional)
- mypy (optional)