Math Modeling Agent (math-modeling)
A three-role pipeline that takes a math-modeling contest problem from analysis to runnable code, figures, and a full Word/LaTeX paper.
EducationAdvanced★ 1,850⑂ 100AI score 9/10Last updated: Sep 29, 2026
What it does
- Three sequential roles: modeler → programmer → paper writer, with the option to run any single stage on its own.
- Modeling outputs: a problem-analysis report and a notation/terminology table in Markdown.
- Code and figures: runnable Python/MATLAB code, result tables (CSV/XLSX), at least 9 figures (≥3 raw-data, ≥3 process, ≥3 result figures covering every sub-question), a mandatory overall modeling flowchart, plus a reproduction manifest with random seeds, input SHA-256, dependency versions and a single repro command.
- Paper: Word (
完整论文.docx) by default, LaTeX source + truly compiled PDF on explicit request, minimum 8 formal figures, with checks on figure numbering, citation cross-references, OMML math, page counts, fonts and image DPI. - Independent QA gates: M1/P1/P2/W1/W2 checkpoints are reviewed by read-only Subagents; a FAIL sends work back to the responsible role. For real deadlines it first secures an immediately submittable Checkpoint version.
Who it's for
- Students and coaches in math-modeling competitions (MCM/ICM-style events).
- Analysts or researchers who need the full chain from formulation to code, plots and a written report.
- Anyone who wants automated consistency checks between computed results and the figures/tables in a document.
Example uses
- "Solve this whole problem from the attached PDF" → analysis, model selection, code, figures, then a Word paper.
- "Just help me choose and justify models" → modeler stage only, returning the analysis report and notation table.
- "Results are done, write the LaTeX paper" → writer stage only; if real results or figures are missing it forces a return to the earlier stage instead of fabricating numbers.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/XiaoMaColtAI/math-modeling-skill/HEAD/dsh-plugin/math-modeling-agent/skills/math-modeling/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the dsh-plugin/math-modeling-agent/skills/math-modeling folder from the GitHub repo XiaoMaColtAI/math-modeling-skill into my ~/.claude/skills/xiaomacoltai-math-modeling/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/XiaoMaColtAI/math-modeling-skill.git && mkdir -p ~/.claude/skills && cp -r math-modeling-skill/dsh-plugin/math-modeling-agent/skills/math-modeling ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal (PowerShell on Windows, Terminal on macOS/Linux).
- Clone the repo:
git clone https://github.com/XiaoMaColtAI/math-modeling-skill.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r math-modeling-skill/dsh-plugin/math-modeling-agent/skills/math-modeling ~/.claude/skills/ - Verify that
~/.claude/skills/math-modeling/containsSKILL.mdplus thereferences/,tools/andassets/folders — the skill will not work without them. - Read
使用指南.md(usage guide) at the repo root and copy it into your project/problem folder as the skill instructs. - Restart Claude Code and ask something like "Use the math-modeling skill on this problem", then confirm the activation message and the reported SKILL_ROOT / PROJECT_ROOT paths.
- Python (computation and plotting) and Word/LaTeX tooling are required; if the skill reports BLOCKED, install the missing engine or dependency.