# python-pro

python-pro is a Claude Code subagent for Python refactoring, performance work, and complex features. It joins these coding tasks and includes tests with its changes.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/python-pro.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-python-pro

## What it does

python-pro examines the project’s existing patterns before changing Python code. It can work with decorators, generators, and asynchronous code, and help locate performance bottlenecks.

It writes `pytest` tests and uses type annotations alongside static analysis with `mypy` and `ruff`. Context7 tools are available for looking up library documentation; sequential-thinking supports work on complex algorithms. Its process calls for lint, type, security, and test checks before a change is considered complete.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/python-pro.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/python-pro.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/python-pro.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/python-pro.md

## When to use it
- refactor existing Python modules
- locate performance bottlenecks
- build complex features with tests
- design asynchronous I/O code

## Example prompts
- Refactor this Python module and add `pytest` tests.
- Find the slow part of this code and suggest an optimization.
- Add asynchronous request handling with type checks.

## Similar
- [gravitas-python](https://affpapa.org/en/nevibecode/skills/gravitas-python.md) — skill · 419 installs
- [python](https://affpapa.org/en/nevibecode/skills/alinaqi-python.md) — skill · 282 installs
- [pare-python](https://affpapa.org/en/nevibecode/mcp/pare-python.md) — MCP server · ★ 141 repo stars
- [python-code-style](https://affpapa.org/en/nevibecode/skills/python-code-style.md) — skill · 16456 installs
- [python-expert](https://affpapa.org/en/nevibecode/agents/0xfurai-python-expert.md) — subagent · ★ 1029 repo stars
- [writing-python](https://affpapa.org/en/nevibecode/skills/writing-python.md) — skill · 134 installs

## Other versions with the same name
- [python-pro · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-community-python-pro.md) — 11689 installs
- [python-pro · wshobson](https://affpapa.org/en/nevibecode/agents/python-pro.md) — 11689 installs
- [python-pro · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-python-pro.md) — ★ 6505 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
