Python

This is a strict, opinionated Python setup centered on modern tooling and test-driven development. It enforces type hints everywhere with mypy in strict mode, uses ruff for linting and formatting, and expects 80% test coverage via pytest. The structure separates pure business logic from side effects, which is clean but requires discipline. You get pre-commit hooks, GitHub Actions configs, and patterns like dependency injection and Pydantic validation out of the box. If you're starting a greenfield Python project or want to tighten up an existing one, this gives you a production-ready foundation. The anti-patterns list alone is worth having around.

skills.sh installs: 175
GitHub stars: 685
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add alinaqi/claude-bootstrap --skill python --agent claude-code

Installs into .claude/skills of the current project.

Files

Python Skill

Type Hints

Use type hints on all function signatures
Use typing module for complex types
Run mypy --strict in CI

def process_user(user_id: int, options: dict[str, Any] | None = None) -> User:
    ...

Project Structure

project/
├── src/
│   └── package_name/
│       ├── __init__.py
│       ├── core/           # Pure business logic
│       │   ├── __init__.py
│       │   ├── models.py   # Pydantic models / dataclasses
│       │   └── services.py # Pure functions
│       ├── infra/          # Side effects
│       │   ├── __init__.py
│       │   ├── api.py      # FastAPI routes
│       │   └── db.py       # Database operations
│       └── utils/          # Shared utilities
├── tests/
│   ├── unit/
│   └── integration/
├── pyproject.toml
└── CLAUDE.md

Tooling (Required)

# pyproject.toml
[tool.ruff]
line-length = 100
select = ["E", "F", "I", "N", "W", "UP"]

[tool.mypy]
strict = true

[tool.pytest.ini_options]
testpaths = ["tests"]
addopts = "--cov=src --cov-report=term-missing --cov-fail-under=80"