Skip to main content
prompt GP ChatGPT

Python Type Hints taste — ChatGPT prompt: rules and setup

The Python Type Hints taste ChatGPT prompt sets conventions for typing Python code. It covers annotations, type choices, and static checking.

CC0-1.0 ★ 178,201 updated 2026-10-24

Open on GitHub

What Python Type Hints taste does

The prompt lays out a typing style for Python projects. It calls for running pyright or mypy in CI on every pull request and failing the build on newly introduced errors. Public functions should have parameter and return annotations, while local variables can rely on inference.

Its guidance covers Protocol, dataclass, TypedDict, Literal, NewType, and narrowing unknown values with checks rather than cast(). It also addresses the py.typed marker for libraries and placing costly imports behind if TYPE_CHECKING:. PEP 695 syntax is recommended for Python 3.12 and later.

What it helps with

  • set stricter type checking for new Python code
  • choose types for public APIs and data structures
  • narrow unknown values instead of spreading Any
  • document each type: ignore with its error code

Example prompts for the agent

  • Review the typing in this Python module using the prompt's conventions.
  • Add annotations to the public functions and narrow the Any values.
  • Suggest typing conventions for a project using Python 3.12 or later.

How to install Python Type Hints taste

How to use

Paste the text at the start of a chat or into project instructions

Questions about Python Type Hints taste

How do I install Python Type Hints taste in Claude Code?

Add the file at .claude/commands/prompts.csv.md.

What does Python Type Hints taste do?

It gives Python typing and static-checking conventions, including guidance on annotations, data models, and narrowing unknown values.

Which Python versions use the PEP 695 syntax recommended here?

The prompt recommends PEP 695 for Python 3.12 and later.

Source text

prompts.csv · CC0-1.0
# Python Type Hints taste of a typed-Python maintainer
- Run a type checker (pyright or mypy) in CI on every pull request and treat new errors as build failures. Confidence: 0.95
- Start strict on new code with `strict = true` and loosen per module only with a written reason, instead of starting loose and tightening never. Confidence: 0.80
- Use modern built-in generics like `list[str]` and `dict[str, int]` and `X | None` instead of importing `List`, `Dict` and `Optional` from `typing`. Confidence: 0.90
- Annotate every public function signature, including the return type; let local variables be inferred unless inference is wrong. Confidence: 0.90
- Accept abstract types in parameters (`Iterable`, `Mapping`, `Sequence`) and return concrete types (`list`, `dict`). Confidence: 0.85
- Prefer `Protocol` for structural interfaces over abstract base classes when callers should not have to inherit anything. Confidence: 0.75
- Model fixed-shape records with `dataclass` (or `pydantic` at I/O boundaries) instead of passing raw dicts around. Confidence: 0.90
- Use `TypedDict` only for dict-shaped data you do not control, such as JSON payloads and legacy APIs. Confidence: 0.75
- Represent a closed set of string options with `Literal` or an `Enum`, never a bare `str`. Confidence: 0.85
- Treat `Any` as a bug report: confine it to the boundary where untyped data enters and narrow it immediately. Confidence: 0.85
- Prefer `object` over `Any` when a value is truly unknown, so the checker forces a narrowing step before use. Confidence: 0.70
- Narrow with `isinstance`, `match` statements and `TypeGuard`/`TypeIs` helpers instead of `cast()`. Confidence: 0.80
- Every `# type: ignore` must name the error code and carry a short comment explaining why it is safe. Confidence: 0.90
- Use `NewType` for IDs and units (`UserId`, `Cents`) that are easy to mix up but share an underlying type. Confidence: 0.70
- Ship a `py.typed` marker in libraries and keep stubs for untyped dependencies in a pinned `types-*` package or a local `stubs/` folder. Confidence: 0.85
- Use `@overload` only when the return type truly depends on argument types; otherwise simplify the API. Confidence: 0.70
- Prefer PEP 695 syntax (`def first[T](xs: list[T]) -> T`) on Python 3.12+ instead of module-level `TypeVar` declarations. Confidence: 0.75
- Annotate `self`-returning builder methods with `Self` rather than a bound `TypeVar`. Confidence: 0.80
- Mark constants with `Final` and override methods with `@override` so refactors surface mistakes. Confidence: 0.70
- Do not add runtime type checks that duplicate the static checker; validate only untrusted input at the edges. Confidence: 0.80
- Keep annotations import-cheap: put heavy imports under `if TYPE_CHECKING:` to avoid circular imports and slow startup. Confidence: 0.75

© f · CC0-1.0 · f/prompts.chat

Similar prompts

All prompts for Programming languages →

From the same set218

The whole set →
SQLite taste SQLite taste — a prompt for ChatGPT that gives practical SQLite guidance. It covers database settings, schema changes, query planning, and backups. GP ChatGPT ★ 178,201repo stars Dependency Management taste Dependency Management taste — a prompt for ChatGPT and Claude.ai that configures AI around a strict dependency management philosophy. Prevents surprise breakages. GP ChatGPT ★ 178,201repo stars Internationalization taste The Internationalization taste ChatGPT prompt sets out product internationalization practices. It covers localized UI text, data formats, and public pages. GP ChatGPT ★ 178,201repo stars API Rate Limiting taste API Rate Limiting taste — a prompt for ChatGPT that defines rate limiting rules for API endpoints. Helps design backend protection against abuse and traffic spikes. GP ChatGPT ★ 178,201repo stars Secrets Management taste Secrets Management taste — a prompt for ChatGPT that defines security standards and best practices for secrets management. GP ChatGPT ★ 178,201repo stars Tokio Async Rust taste The Tokio Async Rust taste prompt for ChatGPT sets engineering conventions for asynchronous Rust services built with Tokio. It applies while writing or reviewing code that handles task cancellation, network timeouts, and shutdown. GP ChatGPT ★ 178,201repo stars Tailwind CSS taste Tailwind CSS taste is a prompt for ChatGPT, Claude.ai, and Claude Code that sets utility-first styling rules, design tokens, and bans arbitrary pixel sizes in Tailwind CSS code. GP ChatGPT ★ 178,201repo stars Vite Frontend Tooling taste The Vite Frontend Tooling taste ChatGPT prompt sets preferences for building frontend projects with Vite. It covers app setup, type checks, tests, and release builds. GP ChatGPT ★ 178,201repo stars

Project sponsors

Companies that keep this analytics open