python

Standardizes Python project setup with typing, pytest tests, and pathlib usage.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pqem/agent-automatizado --skill python-pqem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python
Source: https://github.com/pqem/agent-automatizado/tree/main/templates/skills/tech/python
Command: npx skills add https://github.com/pqem/agent-automatizado --skill python-pqem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Python projects often struggle with inconsistent structure, unclear guidelines for typing, testing, and API design. This guide provides a standardized blueprint for Python development to improve readability and maintainability.

Core Features & Use Cases

  • Structured project layout with src/ and tests/, clear module boundaries.
  • Typing and data modeling with type hints, dataclasses, and Pydantic examples.
  • Best practices: docstrings, pytest-based tests, and pathlib usage over os.path.
  • Use cases: starting a new library or microservice with a consistent baseline.

Quick Start

Create a new Python project following the recommended structure and then run the test suite to validate your setup.

Frequently Asked Questions about python

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

FAQPage Schema
How do I structure a Python project with src and tests directories?

A standardized Python project structure uses a src/ layout with clear module boundaries and a separate tests/ directory. This separation improves readability, maintainability, and provides a consistent baseline for applications, libraries, and APIs.

What's the best way to add type hints and data modeling in Python?

Type hints and data modeling in Python are best handled using type hints, dataclasses, and Pydantic. This approach standardizes data structures across your codebase, improving code reliability and reducing boilerplate for libraries and microservices.

How do I set up pytest tests for a Python library or API?

Setting up pytest tests involves creating a tests/ directory alongside your src/ modules. Using pytest provides a consistent testing framework that validates your setup, satisfies public API requirements, and ensures concrete patterns are demonstrated.

When should I use pathlib instead of os.path in Python development?

Pathlib should be used instead of os.path for all new Python development to ensure best practices. It provides an object-oriented approach to filesystem paths, improving code readability and consistency across small projects and large codebases.

Can I use this Python coding guide for large codebases and microservices?

This Python coding guide applies to large codebases and microservices, scaling from small projects. It standardizes coding practices, typing, testing, and documentation, reducing boilerplate and accelerating onboarding across varying project sizes.