Menu
Use when writing Python 3.12+ — typed application code, async programming, CLI tools (cyclopts, rich), or pandas data manipulation.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | python-pro |
| description | Use when writing Python 3.12+ — typed application code, async programming, CLI tools (cyclopts, rich), or pandas data manipulation. |
Type-safe, async-first, production-ready Python 3.12+: application code, CLI tools, and pandas data work.
Load the matching reference when your task touches its area — each holds the rules and gotchas for that branch, only what the defaults get wrong.
| Reference | Load When |
|---|---|
references/type-system.md | Generics, Protocol, type aliases, exhaustiveness |
references/cli.md | Building or extending a CLI |
references/pandas-gotchas.md | Any DataFrame work — cleaning, groupby, merge, perf |
Packaging and tooling have dedicated skills: use uv for projects/dependencies, ty for type checking, ruff for lint/format.
X | None over Optional[X]; PEP 695 generics (type X = ..., class C[T]:, def f[T]:).__init__; context managers for resource handling; pathlib over os.path.async/await for I/O-bound work; route blocking calls through asyncio.to_thread.None sentinel for mutable defaults.else after a guard is a smell.TaskGroup over bare gather for structured concurrency; asyncio.timeout() over wait_for.Ship the implementation and its pytest suite together. The work is green when all three pass:
uv run ty check # zero errors
uv run ruff check --fix && uv run ruff format
uv run pytest --cov # >90% coverage
Finish only on green.
Build, launch, and drive the mindwalk web UI end-to-end for verification.
Set up or troubleshoot Yassimba's curated agent skills, Pi packages, Herdr, and Herdr plugins through the ai-setup CLI. Use when the user asks to install this collection, configure Herdr, add one of its capabilities, update the setup, or diagnose installation problems.
Backlog management: use when the user mentions a backlog, asks what's next, wants work recorded before implementation, or wants queued ideas or specs prioritized, transitioned, completed, or removed; also use when another skill needs to record lifecycle changes.
Use when the user wants to brainstorm or explore an idea — a feature, product direction, or "what if" — before deciding whether it deserves a plan. Ideation only — ends in an idea brief, not a design.
Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes — Standards (this repo's documented coding standards) and Spec (what the originating issue/PRD asked for). Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X".
Use when creating a git commit — the user asks to commit, or a unit of work is complete and ready to commit.