python-code-style

Configures ruff, strict mypy/pyright, and Google-style docstrings for Python projects.

1|Updated May 11, 2026

Search Tags:#linting #python #code style #type checking #mypy #ruff #docstrings

Ready to run

npx skills add https://github.com/skalanux/puntofiles --skill python-code-style-skalanux

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: python-code-style
Source: https://github.com/skalanux/puntofiles/tree/main/dot_agents/skills/python-code-style
Command: npx skills add https://github.com/skalanux/puntofiles --skill python-code-style-skalanux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents messy, inconsistent Python code by giving a clear, enforceable standard for formatting, linting, naming, type checking, and documentation so teams can move faster with fewer style-related bugs.

Core Features & Use Cases

Modern tooling setup: Configure ruff for unified linting and auto-formatting so style decisions are consistent.
Strong typing guidance: Establish strict mypy or pyright settings to catch type issues early, especially in public APIs.
Clear documentation standards: Use Google-style docstrings and require documentation for public classes and functions.
Naming and import conventions: Apply PEP 8-aligned naming rules and consistent import organization with absolute imports.

Quick Start

Configure ruff and strict mypy in your project by adding the recommended settings to your pyproject.toml, then run ruff check --fix and ruff format to apply the standards automatically.

Frequently Asked Questions about python-code-style

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

FAQPage Schema

How do I set up Python linting and formatting with ruff?▼

Set up Python linting with ruff by adding recommended settings to your pyproject.toml, then run `ruff check --fix` and `ruff format` to automatically apply consistent style standards across your project.

What is the best way to enforce strict type checking in Python?▼

Enforce strict type checking in Python by configuring strict mypy or pyright settings in your project. This catches type issues early, especially in public APIs, reducing style-related bugs and review friction.

How do I standardize Python docstrings for public functions?▼

Standardize Python docstrings by adopting Google-style docstrings and requiring documentation for all public classes and functions. This ensures clear, consistent documentation standards across your codebase.

Can I use PEP 8 naming conventions with automated Python tooling?▼

Yes, you can apply PEP 8-aligned naming rules and consistent import organization using absolute imports. Configuring ruff automates enforcement of these conventions alongside formatting.

How do I prepare a Python project for CI with consistent code style?▼

Prepare a Python project for CI by configuring ruff for unified linting and strict mypy for type checking. Apply 120-character formatting limits and automated enforcement to ensure reliable builds.

Why use ruff instead of other Python linters for code review?▼

Use ruff for unified linting and auto-formatting to ensure style decisions are consistent. It replaces multiple Python linters, reducing inconsistencies and review friction for teams moving faster.