Python Patterns Review skill for Claude and Codex

Python Patterns Review as an AI skill. It asks for The code, Purpose, Python version and 2 more, then does the rest. Free to install in Claude or Codex.

Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.

Download the skill (.zip) · View SKILL.md

When it is used

Use when a Python module or project needs a review of type hints, dataclass use, exception handling, packaging, and test structure. Do not use for debugging a specific failing test or converting a script into a web service. Related topics: coding, technical.

What it will ask you for

• The code (longer free text)
• Purpose (free text, e.g. "What it does and who uses it")
• Python version (free text, e.g. "3.12")
• Focus (choose any: Type hints, Dataclasses, Exceptions, Packaging, Test layout, Async code, Dependencies)
• Type checker in use (choose one: mypy, pyright, None yet)

How it works

1. Skim the code and layout to note public functions, data shapes passed as dicts, try blocks, and where tests live.
2. Check typing on every public function and replace fixed-shape dicts with dataclasses or typed dictionaries where it clarifies intent.
3. Review each exception handler for specificity and useful messages, flagging bare excepts and silent passes.
4. Assess packaging and test layout against the selected focus areas and note gaps that block reuse or CI.
5. Write findings by impact with before and after snippets, then give a small-commit order for landing them.

What you get

A findings list by impact with before and after snippets, then a numbered order of small commits for applying the changes.

What it watches out for

• Adding type hints that the checker accepts but that describe the wrong shape, which hides bugs instead of catching them.
• Turning every dict into a dataclass, including ones that really are open-ended mappings.
• Wrapping a whole function in try and except Exception, so real failures look like normal returns.

How to install

Claude.ai and the Claude desktop app

1. Download the skill .zip.
2. Open Settings, then Capabilities, and find Skills.
3. Choose Upload skill and select the .zip.
4. Ask Claude for help with the task. It loads the skill when your request matches.

Claude Code

1. Download the skill .zip.
2. Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
3. Start a new session. Claude Code loads the skill when your request matches.

Codex

1. Download the skill .zip.
2. Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
3. Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.

Cursor

1. Download the Cursor rule (.mdc).
2. Save it in .cursor/rules/ inside your project.
3. Cursor's agent applies the rule when your request matches its description.

AGENTS.md (Codex, Cursor, and other coding agents)

1. Copy the AGENTS.md section.
2. Paste it into AGENTS.md at the root of your repository, creating the file if needed.
3. Coding agents that read AGENTS.md follow it when your request fits.