Does this skill replace Ruff or MyPy?

No, this skill is designed to complement tools like Ruff and MyPy. It assumes those linters have already passed and focuses on higher-level semantic correctness, architectural patterns, and idiomatic style.

Which version of Python does it target?

It prioritizes modern Python idioms (3.9+), specifically requiring the use of the pipe operator for unions and built-in collection types for hints instead of the older 'typing' module versions.

How does it handle architectural layers?

It enforces strict boundaries between layers. For example, it ensures the service layer does not import from the API layer and that business logic does not leak into repository or route files.

What documentation style does it enforce?

It specifically validates code against the Google Python Style Guide, requiring structured Args, Returns, and Raises sections in docstrings for public functions.

Python Style & Architecture Validator

Name: Python Style & Architecture Validator
Author: peteski22

bypeteski22

•

Developer Tools

Validates Python code against strict architectural patterns, Google-style docstrings, and modern idiomatic conventions.

The python-style skill is a deterministic validation agent designed to maintain high-quality Python codebases. Beyond simple linting, it enforces sophisticated architectural standards such as the separation of concerns between service, repository, and API layers. It ensures code follows modern Python 3.9+ idioms, including specific type hint syntax and exception chaining, while mandating Google-style documentation. This skill is ideal for teams who want to automate the enforcement of structural best practices and prevent the propagation of technical debt during the development process.

Key Features

01Validates modern Python 3.9+ type hint syntax (e.g., str | None, list[str])

02Strictly audits layered architecture boundaries and separation of concerns

03Prevents anti-pattern propagation by flagging new code that copies existing bad practices

04Checks for proper exception chaining using 'raise from' patterns

05Enforces Google-style docstrings with Args, Returns, and Raises sections

0617 GitHub stars

Use Cases

01Pre-commit validation of git diffs to catch semantic and idiomatic violations before code review

02Automating architectural reviews to ensure business logic remains isolated from API route handlers

03Standardizing documentation and type hints across large-scale, multi-developer Python projects

Key Features

01Validates modern Python 3.9+ type hint syntax (e.g., str | None, list[str])

02Strictly audits layered architecture boundaries and separation of concerns

03Prevents anti-pattern propagation by flagging new code that copies existing bad practices

04Checks for proper exception chaining using 'raise from' patterns

05Enforces Google-style docstrings with Args, Returns, and Raises sections

0617 GitHub stars

Use Cases

01Pre-commit validation of git diffs to catch semantic and idiomatic violations before code review

02Automating architectural reviews to ensure business logic remains isolated from API route handlers

03Standardizing documentation and type hints across large-scale, multi-developer Python projects