python-conventions

Enforce PEP 8/257 compliance and type hints in Python 3.12+ code.

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/eric-sabe/engsys --skill python-conventions-eric-sabe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-conventions
Source: https://github.com/eric-sabe/engsys/tree/main/stacks/lang/python/skills/python-conventions
Command: npx skills add https://github.com/eric-sabe/engsys --skill python-conventions-eric-sabe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates inconsistent Python coding practices, missing type hints, non-compliant docstrings, and unhandled edge cases that reduce code readability, increase review friction, and introduce avoidable bugs in Python 3.12+ projects.

Core Features & Use Cases

  • PEP 8/257 Compliance: Enforces 4-space indents, line length guidelines, and proper docstring placement for all Python files.
  • Type Hint Enforcement: Requires type hints on all function parameters and return values, using modern builtin generics where supported.
  • Async & Environment Best Practices: Guides proper async I/O usage, virtualenv discipline, and dependency management for Python projects.
  • Use Case: When your team is collaborating on a Python codebase, use this Skill to automatically align all contributors to the same coding standards, reducing review cycles and preventing style-related merge conflicts.

Quick Start

Use the python-conventions skill to review the attached Python file for compliance with type hint, docstring, and PEP 8 requirements.

Frequently Asked Questions about python-conventions

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

FAQPage Schema
How do I enforce Python type hints and PEP 8 compliance across a collaborative codebase?

Python async I/O best practices require proper async pattern implementation for non-blocking operations. Applying standardized coding conventions ensures async code remains idiomatic, readable, and compliant with Python 3.12+ environments during development and review.

Does this Python coding standard work for Python 3.12+ codebases?

Yes, these Python coding standards are specifically designed for Python 3.12+ codebases. The rules enforce modern builtin generics for type hints and idiomatic syntax, ensuring your code aligns with the latest Python language features and collaborative project requirements.

How do I write PEP 257 compliant docstrings for Python functions?

Writing PEP 257 compliant docstrings requires placing proper documentation immediately following function definitions. Enforcing this standard automatically verifies docstring placement and formatting across all Python files, ensuring consistent module, class, and function documentation.

What is the best way to standardize Python coding standards for a development team?

The best way to standardize Python coding standards is enforcing consistent, idiomatic rules across all authoring and editing tasks. This aligns contributors to identical PEP 8 compliance, type hint usage, and virtualenv discipline, preventing style-related merge conflicts.

Why does missing Python type hints increase code review cycles?

Missing Python type hints increase code review cycles by reducing code readability and introducing avoidable bugs. Enforcing type hints on all function parameters and return values eliminates these inconsistencies, lowering review friction and preventing style-related merge conflicts.