python-dev-guidelines

Standardize Python 3.12+ projects with typing, pytest, and modern packaging.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/NmBoyd/claude_setup --skill python-dev-guidelines
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-dev-guidelines
Source: https://github.com/NmBoyd/claude_setup/tree/main/.claude/skills/python-dev-guidelines
Command: npx skills add https://github.com/NmBoyd/claude_setup --skill python-dev-guidelines

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Establishes consistent Python development standards to improve code quality, readability, and maintainability across projects.

Core Features & Use Cases

  • Enforces modern Python 3.12+ patterns, typing discipline, and testing practices.
  • Standardizes project structure, documentation, and packaging with tools like ruff, mypy, and Google-style docstrings.
  • Use cases include starting new Python modules, classes, or projects, updating existing codebases to align with best practices, and setting up robust testing and packaging workflows.

Quick Start

Follow the New Python Project Checklist to begin a compliant Python project using these guidelines.

Frequently Asked Questions about python-dev-guidelines

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

FAQPage Schema
How do I set up a Python project structure for Python 3.12 with strict typing?

To set up a Python project structure for Python 3.12 with strict typing, standardize your modules using modern packaging like pip or poetry, enforce type hints with mypy, and organize imports consistently to ensure maintainable code.

What is the best way to enforce Python linting and testing standards in a new project?

The best way to enforce Python linting and testing standards is to configure ruff for linting and use pytest-based tests, which standardizes code quality and validates functionality across modern Python projects.

Do I need Pydantic v2 to use modern Python data classes and async/await patterns?

You do not strictly need Pydantic v2 to use async/await patterns or standard data classes, but adopting Pydantic v2 models ensures strict data validation and aligns with modern Python 3.12+ development guidelines.

How does Google-style docstrings improve Python code readability?

Google-style docstrings improve Python code readability by standardizing documentation formats across modules and classes, ensuring that function arguments, returns, and descriptions are consistently structured for maintainability.

Can I use poetry for packaging while applying strict mypy typing checks?

You can use poetry for packaging while applying strict mypy typing checks, as these guidelines standardize modern packaging workflows alongside strict typing discipline to maintain robust Python project environments.

When should I not apply async/await patterns in Python development?

You should not apply async/await patterns when synchronous execution is sufficient, as standardizing Python development practices requires matching modern language features to appropriate use cases to avoid unnecessary complexity.