pep8

Enforce PEP 8, typing, and docstring standards on Python 3.11+ codebases.

27|9|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill pep8
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pep8
Source: https://github.com/georgekhananaev/claude-skills-vault/tree/main/.claude/skills/pep8
Command: npx skills add https://github.com/georgekhananaev/claude-skills-vault --skill pep8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps teams enforce modern Python 3.11+ standards, ensure consistent style, typing, and clear docstrings, reducing code-review churn and improving readability.

Core Features & Use Cases

  • PEP 8 conformance and formatting across Python codebases.
  • Enforced type hints and modern typing patterns (PEP 484/585, PEP 604).
  • Docstring style enforcement (Google-style) to improve maintainability.
  • Integrates into development workflows (local checks, PR reviews, CI) to catch issues early.
  • Use Case: A team migrating to Python 3.11+ ensures new code follows standardized guidelines automatically during reviews.

Quick Start

Install the required tooling (ruff, pycodestyle, mypy) and run the checks on your codebase.

  • Run full style checks: python scripts/check_style.py src/ --fix
  • Validate formatting only: python scripts/check_pep8.sh src/
  • Auto-fix issues: scripts/fix_style.sh src/

Frequently Asked Questions about pep8

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

FAQPage Schema
How do I auto-enforce PEP 8 and type hints across a Python 3.11 codebase?

To enforce PEP 8 and type hints across Python 3.11 code, run automated style checks using ruff, pycodestyle, and mypy. The skill applies PEP 484/585 and PEP 604 modern typing standards while validating formatting and docstrings.

What's the best way to automate Python 3.11 type hint and docstring checks in CI?

Automating Python 3.11 type hint and docstring checks in CI involves running scripts that validate Google-style docstrings and mypy typing patterns. This catches style issues early during PR reviews and reduces code-review churn.

Can I auto-fix PEP 8 formatting issues and import sorting for Python projects?

You can auto-fix PEP 8 formatting issues and enforce consistent imports by running the provided shell scripts. Executing fix_style.sh applies automatic corrections to the source directory, ensuring standardized Python code formatting.

Does this Python linting approach support modern typing patterns like PEP 604?

This Python linting approach fully supports modern typing patterns including PEP 604 union types and PEP 484/585. It enforces these 3.11+ features alongside PEP 257 docstrings to improve codebase maintainability and readability.

Do I need ruff and mypy to enforce Python 3.11 coding standards?

Yes, you need ruff, pycodestyle, and mypy installed to enforce Python 3.11 coding standards. These tools power the underlying scripts that validate type hints, formatting, and PEP 8 conformance across your project.

When do I need to enforce Python 3.11 coding standards during a migration?

You need to enforce Python 3.11 coding standards during a migration to ensure new code follows standardized guidelines automatically. Applying these checks during local development and code reviews prevents legacy patterns from entering the updated codebase.