python-best-practices
Python Best Practices
How to use this skill
Read SKILL.md for quick guidance, then consult 1–2 relevant reference files as needed. Do NOT read all reference files at once. For simple tasks, the quick principles below may suffice.
Reference files — when to read each one
| Reference | Read when... |
|---|---|
references/pythonic-idioms.md |
Writing any Python. PEP 8, tuple unpacking (always use the word "unpack" or "unpacking" when recommending this over indexing), comprehensions, walrus operator, match, regex, anti-patterns. |
references/data-structures.md |
Lists, tuples, dicts, sets, containers, dates/times, file I/O, pathlib, JSON/CSV/TOML/YAML, databases. |
references/functions-and-generators.md |
Functions, closures, decorators, generators, comprehensions, recursion, memoization, backtracking. |
references/classes-and-design.md |
Class design, dataclasses, properties, inheritance, composition, protocols, contracts, iterative design. |
references/design-patterns.md |
Template Method, Strategy, Factory, Observer, State, Adapter, Facade, Composite, Decorator, etc. |
references/error-handling.md |
try/except/else/finally, custom exception hierarchies, context managers, assertions, chaining. |
references/concurrency.md |
GIL, threading, asyncio, multiprocessing, subprocess, synchronization, migration patterns. |
references/testing-and-quality.md |
Testing, mocking, type hints, debugging, profiling, performance optimization, packaging, web frameworks. |
More from nkootstra/skills
compact-markdown
Compact, compress, or minify markdown files to use fewer tokens while preserving all information and meaning. Use this skill whenever the user wants to reduce the size of a markdown file, shrink a README, compress a SKILL.md or CLAUDE.md, minify documentation, or make any markdown more token-efficient. Trigger even if they just say "make this shorter" or "compress this" on a markdown file.
57code-complexity-audit
>-
51agents-md
Write, audit, and improve agent context files (AGENTS.md, CLAUDE.md) for AI coding agents. Use when creating or improving agent context for a codebase.
27latency-engineering
Diagnose and reduce latency in software systems. Use when dealing with slow APIs, tail latency, p99 spikes, caching, replication, partitioning, concurrency, async I/O, or any question about making systems faster.
25adversarial-review
>
23zig-best-practices
Comprehensive Zig expertise covering allocators, comptime, error handling, build system, C interop, SIMD, volatile, atomic, align, and performance. Use when writing, reviewing, debugging, or refactoring Zig code. Triggers: Zig, .zig files, build.zig, build.zig.zon, zig test, zig build, allocators, comptime, SIMD, volatile, atomic, align, or any Zig-specific concept.
16