kieran-python-reviewer

Review Python diffs for typing, structure, and regression risks as JSON findings.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/xbpk3t/ce-codex --skill kieran-python-reviewer-xbpk3t
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kieran-python-reviewer
Source: https://github.com/xbpk3t/ce-codex/tree/main/skills/kieran-python-reviewer
Command: npx skills add https://github.com/xbpk3t/ce-codex --skill kieran-python-reviewer-xbpk3t

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a focused, high-bar Python code-review persona that detects missing type information, non-Pythonic structure, regression risks, and resource/exception handling issues in diffs touching Python code, helping maintainers avoid subtle regressions and long-term maintenance debt.

Core Features & Use Cases

  • Type and shape scrutiny: Flags public code paths that lack meaningful annotations or abuse loose typing like dict[str, Any].
  • Structural and readability checks: Identifies unnecessary ceremony, poor responsibilities, and name/boundary issues that reduce clarity.
  • Regression and safety focus: Highlights changed exception handling, removed branches, or resource management regressions with confidence calibration and actionable remediation suggestions.
  • Use Case: Run on a pull request that modifies several Python modules to produce a JSON-formatted review highlighting missing annotations, risky refactors, and test gaps.

Quick Start

Review the provided Python diff and return a JSON findings report that lists issues, confidence levels, residual risks, and testing gaps.

Frequently Asked Questions about kieran-python-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Python code review on a pull request diff?▼

Automate Python code review by applying a strict reviewer persona to pull request diffs, which analyzes typing, readability, structural issues, and regression risk to produce a JSON-formatted findings report.

What is static typing scrutiny in a Python code review?▼

Static typing scrutiny in a Python code review flags public code paths that lack meaningful annotations or abuse loose typing like dict[str, Any] to prevent long-term maintenance debt.

How do I check Python diffs for regression risk and exception handling issues?▼

Check Python diffs for regression risk by analyzing changed exception handling, removed branches, and resource management regressions, generating findings with confidence calibration and actionable remediation suggestions.

Can I get a JSON output with confidence scores from a Python diff analysis?▼

Yes, Python diff analysis can produce a JSON findings report that explicitly lists issues, confidence levels, residual risks, and testing gaps suitable for automated parsing.

Does strict Python code review identify non-Pythonic structure and readability issues?▼

Strict Python code review identifies unnecessary ceremony, poor responsibilities, and name or boundary issues that reduce clarity, targeting non-Pythonic structure for maintainability.

What is the best way to find testing gaps in modified Python modules?▼

Find testing gaps in modified Python modules by running a focused diff analysis that highlights missing annotations, risky refactors, and test gaps within a structured JSON review report.