validate-python-style

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

22|3|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/peteski22/claude-pragma --skill validate-python-style
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-python-style
Source: https://github.com/peteski22/claude-pragma/tree/main/skills/validators/python-style
Command: npx skills add https://github.com/peteski22/claude-pragma --skill validate-python-style

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams enforce consistent Python code quality by validating docstrings, type hints, error handling, and architectural patterns.

Core Features & Use Cases

  • Docstring validation: Google-style docstrings with Args, Returns, and Raises.
  • Type hints: enforce modern syntax (str | None) and correct usage.
  • Architecture: ensure layered architecture and separation of concerns.
  • Use Case: during CI, run the validator to catch documentation and structure issues before review.

Quick Start

Integrate into your CI workflow and run on changed Python files to validate docstrings, typing, and architecture. Review any reported issues and update code accordingly. Add the validator as a pre-commit or CI step to enforce standards automatically.

Frequently Asked Questions about validate-python-style

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

FAQPage Schema
How do I validate Python docstrings to ensure they follow Google-style conventions?

To validate Python docstrings, enforce Google-style sections including Args, Returns, and Raises. This validation checks documentation quality during automated reviews to ensure consistent formatting and complete parameter documentation across the project.

How do I enforce modern type hints in Python code reviews?

Enforce modern type hints in Python code reviews by validating modern union syntax like str | None. This ensures correct typing discipline and modern syntax usage across the project during automated CI checks.

What is the best way to check for explicit exception chaining in Python?

Checking for explicit exception chaining in Python involves validating error handling patterns to ensure exceptions are raised with explicit chaining. This enforces proper error handling conventions during automated CI checks.

Can I validate layered architecture and separation of concerns in a Python project?

Yes, you can validate layered architecture and separation of concerns in a Python project. This checks architectural conventions during automated reviews to ensure structural boundaries are maintained across the codebase.

Do I need to run linting and type-checking before validating Python architecture?

Yes, you should run linting and type-checking before validating Python architecture. This architectural and docstring validation assumes prior linting and type-checking have already been performed to catch structural issues.

How do I integrate Python style validation into my CI workflow?

Integrate Python style validation into your CI workflow by adding it as a pre-commit or CI step. Run the validator on changed Python files to catch documentation, typing, and architecture issues before review.