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.