python-code-reviewer

Installation
SKILL.md

Preconditions

  • Python code and code/Qx/qx_code_plan.md exist.
  • Approved method decision, method card, data profile, and relevant run summary are available.
  • Required inputs are accessible.

Workflow

  1. Resolve the approved main and usable baseline. Flag scripts for unapproved candidates unless a fallback activation exists.
  2. Inspect and run the code in the intended order.
  3. Evaluate required checks:
    • syntax: imports, execution, exceptions, and obvious runtime faults.
    • input_contract: paths, fields, units, shapes, missing-data handling, and raw-data protection.
    • method_alignment: formulas, objectives, constraints, assumptions, main/baseline roles, and fallback scope match the approved plan.
    • reproducibility: seed, deterministic setup, dependency/runtime record, and rerun consistency.
    • output_contract: saved tables/metrics/figures, valid run summary, comparable main/baseline metrics, degeneracy evidence, and fallback-trigger state.
  4. Add risk-specific checks only when relevant, such as leakage, constraint feasibility, numerical stability, or scale.
  5. If asked to fix findings, make minimal changes, rerun affected checks, and record the repair. Otherwise report findings without changing code.
  6. Save code/Qx/reviews/qx_python_review.json.
Installs
17
GitHub Stars
793
First Seen
Jun 16, 2026
python-code-reviewer — zhnnky329/mathmodeling-skills