check-python-style

Validate Python code style, type hints, and Google-style docstrings.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/sunLeee/optimization --skill check-python-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-python-style
Source: https://github.com/sunLeee/optimization/tree/main/.claude/skills/quality/check/python-style
Command: npx skills add https://github.com/sunLeee/optimization --skill check-python-style

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates Python code against style, typing, and documentation standards to prevent maintainability issues and CI failures.

Core Features & Use Cases

  • Lint and style checks: Enforces PEP8 compliance using ruff.
  • Type checking: Verifies type hints with mypy in strict mode.
  • Docstring quality: Encourages Google-style docstrings and clear documentation.

Quick Start

Run a quick style audit on your project to surface immediate violations and suggested fixes.

Frequently Asked Questions about check-python-style

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check Python code style and type hints before CI?

To check Python code style and type hints before CI, you can automate validation for PEP8 compliance, strict typing, and Google-style docstrings to prevent maintainability issues and CI failures across codebases of any size.

What's the best way to enforce PEP8 and Google-style docstrings in Python?

Enforcing PEP8 and Google-style docstrings in Python is best handled by automating lint checks and basic docstring structure verification, which surfaces immediate violations and suggested fixes during development or code reviews.

How does mypy strict mode work for validating Python type hints?

Mypy strict mode validates Python type hints by verifying type annotations across the codebase, ensuring strict typing validation is enforced before code reaches CI pipelines to prevent typing violations.

Can I use ruff and mypy with uv run for Python linting?

Yes, you can use ruff and mypy execution via uv run to perform lint checks and strict typing validation, ensuring Python code meets style, typing, and documentation standards without additional configuration.

Does Python code style validation work for large codebases during code reviews?

Python code style validation is applicable to codebases of any size during code reviews, detecting linting, typing, and documentation violations to ensure quality standards are met before merging.

Why does my Python CI pipeline fail due to typing and documentation violations?

Your Python CI pipeline fails due to typing and documentation violations when code lacks strict type hints or Google-style docstrings, which automated validation checks detect before CI execution.