Can I use this for older Python versions?

While the skill recommends modern features (Python 3.10+), the configurations for Ruff and Mypy can be easily adjusted to support older versions.

Which docstring format does this skill follow?

It defaults to the Google-style docstring format, which is widely recognized for its balance of readability and structure for complex function signatures.

How does it improve type safety?

It provides strict Mypy and Pyright configurations that enforce type annotations on all public APIs, catching potential runtime errors during development.

Does this skill support both Ruff and Black?

Yes, although it prioritizes Ruff as an all-in-one replacement for Black, Flake8, and isort to provide faster performance and unified configuration.

Python Code Style & Documentation

Name: Python Code Style & Documentation
Author: wshobson

bywshobson

•

27,605

•

Developer Tools

Enforces Python PEP 8 standards, Ruff linting, and Google-style documentation for maintainable and professional codebases.

The Python Code Style skill empowers Claude to act as a rigorous technical lead by applying modern Python development standards to your projects. It automates the configuration of high-performance tools like Ruff and Mypy, establishes consistent naming conventions based on PEP 8, and ensures high-quality documentation using the Google docstring format. This skill is essential for teams looking to standardize their codebases, developers initializing new projects with modern pyproject.toml structures, and anyone seeking to improve code readability and type safety through automated formatting and strict architectural patterns.

Key Features

01Google-style docstring generation for comprehensive API documentation

02Modern Python project structure guidance including pyproject.toml and README templates

03Consistent import organization using absolute import patterns

04Automated Ruff and Mypy configuration for linting and strict type checking

0527,605 GitHub stars

06Standardized PEP 8 naming conventions for modules, classes, and functions

Use Cases

01Initializing a new Python project with industry-standard linting and formatting presets

02Refactoring legacy Python code to meet current type-hinting and style requirements

03Generating professional project documentation and change logs for open-source contributions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add wshobson/agents python-code-style

For use in Claude.ai and ChatGPT

Download Skill