Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments…

MITAuto-check passedDocuments & Office

Install My Mathmodel Agent

skills CLI
$ npx skills add chengyike20110519-create/MathModelRun --skill my-mathmodel-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install chengyike20110519-create/MathModelRun my-mathmodel-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/chengyike20110519-create/MathModelRun.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/my-mathmodel-agent .claude/skills/my-mathmodel-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
my-mathmodel-agent
GitHub stars
128
Token cost
~923 tokens
SKILL.md length
360 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments…

  • Works in 4 steps: Read state.json, project_manifest.json,… → Find the first gate whose value is false. → Read only the stage contract needed for… → …
  • Similar contests
  • SKILL.md covers Startup ritual, Stage machine, Core contracts and Role subagents, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

My Mathmodel Agent is an agent skill from chengyike20110519-create/MathModelRun. Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments, freeze results, write LaTeX or Typst papers, render, and audit every claim. Use for CUMCM, MCM/ICM, HiMCM, and similar contests; not for casual homework or one-off coding questions.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Model routing and gateways and LaTeX. It works with Python and LaTeX. The repository describes itself as: Evidence-driven mathematical modeling workflow for CUMCM, MCM/ICM, and HiMCM: from problem files to reproducible experiments, audited papers, and defensible results. The licence is MIT.

When your agent uses it

  • Similar contests
  • Not for casual homework
  • One-off coding questions

Example prompts

  • “/my-mathmodel-agent”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read state.json, project_manifest.json, and PROGRESS.md.
  2. Find the first gate whose value is false.
  3. Read only the stage contract needed for that gate.
  4. Work on one gate at a time and update the durable handoff log.

What it can do on your machine

Read from SKILL.md and the folder at commit b5cb535. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

My Mathmodel Agent loads about 923 tokens when it runs. Until then it costs about 99 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~923

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from chengyike20110519-create/MathModelRun at commit b5cb535, republished under its MIT licence (© chengyike20110519-create). 360 words, ~923 tokens.

Download SKILL.mdSave it as .claude/skills/my-mathmodel-agent/SKILL.md (or your agent's skills folder).
name
my-mathmodel-agent
description
Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments, freeze results, write LaTeX or Typst papers, render, and audit every claim. Use for CUMCM, MCM/ICM, HiMCM, and similar contests; not for casual homework or one-off coding questions.

MathModel Run

Use this skill when working on Chinese or international mathematical modeling contest projects that need a reproducible path from problem files to a defensible paper.

This is the Claude Code skill entry point. For Codex, use my-mathmodel-agent/SKILL.md in the repository root.

Startup ritual

  1. Read state.json, project_manifest.json, and PROGRESS.md.
  2. Find the first gate whose value is false.
  3. Read only the stage contract needed for that gate.
  4. Work on one gate at a time and update the durable handoff log.

Stage machine

text
S0 PREFLIGHT  → S1 ANALYZE  → S2 ROUTE  → S3 DATA_PLAN
→ S4 METHOD_POC  → S5 EXPERIMENT  → S6 FREEZE
→ S7 WRITE  → S8 RENDER  → S9 AUDIT  → READY

The required state gates are:

text
input_snapshot
problem_decomposed
model_route_selected
data_plan_ready
method_validated
experiments_reproduced
results_frozen
paper_written
pdf_verified
audit_passed

Every gate starts false. A gate becomes true only after independent, reproducible evidence exists in audit/gate_evidence.json.

Core contracts

  • Each subproblem gets planning/problem_analysis.json with observable acceptance criteria.
  • Each model route records baseline, primary_model, fallback_model, rejected alternatives, and a validation plan.
  • Each experiment run records command, input hash, parameters, seed, environment, metrics, logs, and outputs.
  • Paper numbers may only come from frozen_numbers.json.
  • Each paper claim maps through paper/evidence_map.json to a frozen value, figure, or run.
  • Every PDF page is checked in paper/render_log.json.
  • Final readiness requires zero hard errors in audit/final_report.md.

Role subagents

Invoke the role agents under .claude/agents/:

  • mathmodel-analyst: decompose problem facts, assumptions, ambiguities, and acceptance criteria.
  • mathmodel-modeler: define symbols, assumptions, objectives, constraints, and model routes.
  • mathmodel-coder: implement reproducible experiments and logs.
  • mathmodel-writer: assemble the paper only from frozen evidence.
  • mathmodel-reviewer: independently reproduce evidence and audit the project.
Show full SKILL.md (133 more words)Show less

Recovery

Return to the earliest invalid gate:

  • question or data scope → S1
  • model route → S2
  • data leakage or units → S3
  • PoC → S4
  • experiment or solver status → S5
  • numbers → S6
  • claim or evidence mismatch → S7
  • compile or layout → S8

Use the recorded fallback instead of silently changing the model. Append KEEP/CUT/DEFER/PIVOT/ACCEPT_RISK decisions to planning/decision_log.jsonl.

Completion behavior

Do not claim completion because code ran, a solver returned success, or a PDF compiled. Report stage, artifacts, reproduced evidence, risks, and next entry point. Completion requires all gates true and a final independent audit with zero hard errors.

For detailed stage instructions, read my-mathmodel-agent/references/workflow-contract.md. For machine-readable JSON shapes, read my-mathmodel-agent/references/artifact-contracts.md. For final review scoring, read my-mathmodel-agent/references/evaluation-rubric.md.

When updating a user-requested file, replace the current version at its original path and remove obsolete content or duplicate old versions.

© chengyike20110519-create, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/my-mathmodel-agent of chengyike20110519-create/MathModelRun.

Open the folder on GitHubat commit b5cb535

Compare with similar skills

My Mathmodel Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

My Mathmodel Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
My Mathmodel Agent this skillchengyike20110519-create/MathModelRun128—~923Automated safety check: PassMIT
Mathmodel SkillhandsomeZR-netizen/mathmodel-skill292—~2.5kAutomated safety check: PassMIT
Literature Surveyai4s-research/ai4s-skills2372 repos~2kAutomated safety check: PassMIT
MineruNebutra/MinerU-Skill123—~504Automated safety check: PassMIT
Cumcm Live Workflowhaoxilin/cumcm-live-workflow-skill181—~3.6kAutomated safety check: PassMIT
Academic LaTeX Formatterlingzhi227/agent-research-skills390—~603Automated safety check: PassNone

Similar skills

  • Mathmodel Skill

    handsomeZR-netizen/mathmodel-skill

    CUMCM 国赛、MCM/ICM 美赛与电工杯数学建模竞赛的端到端协作工作流。Use when a user explicitly works on one of these modeling contests or asks to run/review a modeling-competition paper from problem selection through modeling…

    292 GitHub stars~2.5k tokensUpdated 14 days ago
    Documents & OfficeAuto-check passed
  • Literature Survey

    ai4s-research/ai4s-skills

    A skill your agent uses when the user wants a comprehensive literature survey on a specific research topic.

    237 GitHub starsUsed in 2 repos~2k tokens
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~504 tokensUpdated 16 days ago
    Documents & OfficeAuto-check passed
  • Cumcm Live Workflow

    haoxilin/cumcm-live-workflow-skill

    CUMCM(全国大学生数学建模竞赛)真题全流程实战手册。用于完整打一场数模竞赛(环境准备→读题自查→建模出图→LaTeX论文→交叉审阅→填表→AI自查表终审→清理打包),内含题意理解红线、数值严谨性守则、去AIGC特征清单、写作规范、LaTeX编号与图表规范、2026…

    181 GitHub stars~3.6k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed
  • Academic LaTeX Formatter

    lingzhi227/agent-research-skills

    Sets up conference-specific LaTeX paper templates, checks a draft for formatting and submission issues, and auto-fixes common problems for venues like ICML, ICLR, NeurIPS, AAAI and ACL.

    390 GitHub stars~603 tokensUpdated 7 mo ago
    Documents & OfficeAuto-check passed
  • Latex Thesis Zh

    brycewang-stanford/Auto-Empirical-Research-Skills

    Chinese LaTeX thesis assistant for existing .tex degree thesis projects (XeLaTeX/LuaLaTeX/latexmk).

    4.6k GitHub stars~1.5k tokensUpdated 5 days ago
    Documents & OfficeAuto-check passed

More from chengyike20110519-create/MathModelRun

  • My Mathmodel Agent

    chengyike20110519-create/MathModelRun

    Evidence-driven mathematical modeling contest workflow for CUMCM, MCM/ICM, HiMCM, Huawei Cup, and similar events.

    128 GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed

Works with

Questions about My Mathmodel Agent

What does My Mathmodel Agent do?

Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments…. My Mathmodel Agent is an agent skill from chengyike20110519-create/MathModelRun. Evidence-driven mathematical modeling contest workflow for Claude Code: decompose a problem, select baseline/primary/fallback model routes, validate PoCs, run reproducible Python/AMPL experiments, freeze results, write LaTeX or Typst papers, render, and audit every claim.

When should I use My Mathmodel Agent?

My Mathmodel Agent fits situations like: similar contests; not for casual homework; one-off coding questions.

How do I install My Mathmodel Agent in Claude Code?

Run `npx skills add chengyike20110519-create/MathModelRun --skill my-mathmodel-agent -a claude-code`. Or copy the skill folder (.claude/skills/my-mathmodel-agent in chengyike20110519-create/MathModelRun) into .claude/skills/my-mathmodel-agent in your project. Claude Code loads it when a task matches its description.

How do I install My Mathmodel Agent in Codex?

Run `npx skills add chengyike20110519-create/MathModelRun --skill my-mathmodel-agent -a codex`. Or copy the skill folder (.claude/skills/my-mathmodel-agent in chengyike20110519-create/MathModelRun) into .agents/skills/my-mathmodel-agent in your project. Codex loads it when a task matches its description.

Can I use My Mathmodel Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chengyike20110519-create/MathModelRun --skill my-mathmodel-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/my-mathmodel-agent, .gemini/skills/my-mathmodel-agent, .github/skills/my-mathmodel-agent and .opencode/skills/my-mathmodel-agent in your project.

What does My Mathmodel Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: My Mathmodel Agent is instructions for the agent only.

Does My Mathmodel Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is My Mathmodel Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does My Mathmodel Agent use?

My Mathmodel Agent is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does My Mathmodel Agent use?

About 923 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to My Mathmodel Agent?

Skills that share tags, products or a category with My Mathmodel Agent: Mathmodel Skill (handsomeZR-netizen/mathmodel-skill, 292 stars), Literature Survey (ai4s-research/ai4s-skills, 237 stars), Mineru (Nebutra/MinerU-Skill, 123 stars) and Cumcm Live Workflow (haoxilin/cumcm-live-workflow-skill, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains My Mathmodel Agent?

chengyike20110519-create (a GitHub user) maintains it in chengyike20110519-create/MathModelRun, which has 128 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 6, 2026.

Source: chengyike20110519-create/MathModelRun on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.