Mathodology Review Questions

SkillDocs & knowledge

Use when running Mathodology award-workflow phase gates, judge panels, structured handoffs, figure QA, or rendered-PDF QA in a contest run.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Mathodology Review Questions skill

What this skill tells your AI

The instructions your AI receives, as published by sweetcornna/mathodology in .claude/skills/mathodology-award-gates/SKILL.md and read by ahel’s review.

The legacy skill name is retained for discovery. Review the substance of the work; do not estimate awards from invented numeric thresholds or require a particular handoff format. Scale review to the claims and the deadline.

Mathematical and empirical questions

  • Does the solution answer every required question and represent its essential mechanisms?
  • Are equations, units, constraints and limiting cases consistent? Is the solution feasible?
  • Can the parameters be identified from the available observations?
  • Does the described method match the code, including preprocessing and exclusions?
  • Is a reported advantage measured against an appropriate baseline on comparable data?
  • Are fitting, tuning and evaluation separated where the claim requires it?
  • Are outcomes forced by normalization or constraints labeled as such?
  • Could plausible changes to important assumptions reverse the recommendation?
  • Are confidence intervals, predictive intervals and simulation variability distinguished?
  • Can reported numbers be traced to data, code, a derivation or a stated assumption?
  • Are evidence gaps, failed runs and material limitations disclosed?

Use relevant questions, not every possible test. When scenarios share comparable random inputs, paired simulations may improve precision; explain the coupling. Use Monte Carlo uncertainty for estimated probabilities, and disclose the number of simulations. Do not claim proof from a handful of successful runs.

Figures and paper

Load figure presets. Read figures at the size used in the final document. Check labels, uncertainty definitions, legends, color scales and captions against the underlying results. Inspect dense pages of the compiled PDF as well as individual exports. Image2 imagery must remain consistent with the mechanism; generated pixels are not quantitative evidence.

The optional PDF overview utility requires Poppler's pdftoppm and Matplotlib. It creates a page overview for visual review:

python3 .claude/skills/mathodology-award-gates/scripts/make_contact_sheet.py solution.pdf -o overview.png

An overview helps find layout problems; zoom into dense pages to judge actual legibility. A successful render is not a certificate of quality.

Useful review output

Explain each material issue, its evidence, its effect on the conclusion and a concrete fix. Distinguish errors from optional improvements. Correct consequential errors before relying on the result; disclose unresolved uncertainty. Never require the user to approve routine fixes or invent a scoring ceremony.

Signals

GitHub stars
229
Forks
12
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
mathodology-award-gates
Source
github.com/sweetcornna/mathodology