Python Code Quality Skill

Python Code Quality Skill

Ensure Python code follows best practices with automated linting, formatting, and type checking using ruff and mypy.

When to Use This Skill

Use this skill when:

• User requests code linting or formatting
• User mentions code quality, PEP 8, or style issues
• User wants to fix linting errors
• User asks about type checking
• Code review processes require quality checks

Core Capabilities

1. Linting with Ruff

   • Check code for style violations
   • Identify potential bugs and code smells
   • Enforce PEP 8 compliance
   • Auto-fix issues where possible

2. Code Formatting

   • Format code consistently with ruff
   • Organize imports automatically
   • Ensure consistent indentation and line length

3. Type Checking with Mypy

   • Verify type annotations are correct
   • Catch type-related bugs before runtime
   • Ensure type safety across the codebase

4. Code Quality Metrics

   • Complexity analysis
   • Dead code detection
   • Unused import identification

Context Files

This skill references the following context files in this directory:

• ruff-configuration.md - Ruff linting and formatting rules
• mypy-configuration.md - Type checking configuration
• common-issues.md - Common Python code quality issues and fixes
• best-practices.md - Python coding best practices

Key Tools and Commands

# Linting
ruff check .                    # Check for issues
ruff check --fix .              # Auto-fix issues
ruff check --watch .            # Watch mode

# Formatting
ruff format .                   # Format all files
ruff format --check .           # Check if formatting needed

# Type checking
mypy src                        # Check types
mypy --strict src               # Strict mode

Common Workflows

Pre-commit Quality Check

ruff check --fix . && ruff format . && mypy src

CI/CD Pipeline

ruff check .                    # Fail if unfixed issues
ruff format --check .           # Fail if unformatted
mypy src                        # Fail on type errors

Expected Outcomes

After using this skill:

• All code follows PEP 8 style guidelines
• Imports are properly organized
• Type hints are correct and comprehensive
• Code is consistently formatted
• Common bugs and issues are identified

Integration with Other Skills

• Works with python-project-setup for initial configuration
• Complements python-testing for comprehensive quality assurance
• Used by python-project-setup agent for automated checks