cumcm-paper-hand-skill

A skill for writing a mathematical modeling contest paper: LaTeX template, writing rules and five analyzed winning papers

  • 214 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The agent creates and overwrites files in the participant's folder and runs LaTeX compilation, so keep the source materials under version control or in a copy
All reasons and checks

mr-potato-123/cumcm-paper-hand-skill

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/cumcm-paper-hand-skill

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The agent creates and overwrites files in the participant's folder and runs LaTeX compilation, so keep the source materials under version control or in a copy

This is third-party code. Review the repository files before installing.

What it does

The skill walks an agent through the folder of a participant in the Chinese CUMCM or the American MCM/ICM modeling contest and writes the final paper from ready materials. Work goes in three steps: survey the folder, check the materials for each problem and write the text. A finished solution is taken as it is and the model is not rebuilt. If a problem has no notes or results, the agent asks the participant first. The paper is assembled from `references/论文写作规范.md` and the template `templates/论文模板.tex`. The structure is: abstract, problem restatement, problem analysis, assumptions, symbols, model building and solution, evaluation and extension, references, appendices. Each sub-problem closes with a loop of analysis, model, solution, result review and summary. The result is compiled with XeLaTeX to zero errors, producing `论文.tex` and `论文.pdf`. The `ref/` directory holds five winning contest papers as PDFs and recognized text. They cover three problem types: optimization, physics and data. For types B and C there are pairs of different approaches to the same problem. Every number in the paper must trace back to files in `结果/` or `代码/`, and the agent verifies references by search.

Who it is for. Students preparing a paper for CUMCM or MCM/ICM who already have the model and calculations and need the write-up brought to contest standards.

Good fit when

  • Solutions to the problems sit in folders and you need to assemble a paper with an abstract and appendices
  • You need a LaTeX template for a contest paper that compiles with XeLaTeX without errors
  • You want to see how abstracts and chapters are built in winning papers of different problem types
  • Before submission you need to run the paper through a checklist: data references, bibliography, appendices
  • After the Chinese version you need an English draft for MCM/ICM

Not a fit when

  • There is no model or calculations yet: the skill writes the paper from ready materials, and the full modeling cycle starts only on an explicit request
  • You need an explanation of an algorithm or general math concepts: the skill excludes itself for such a question
  • You have already picked a different modeling skill
  • The submission must be a Word document: the output format here is only LaTeX and PDF

Example request

Help me write the paper from my solutions in this folder: check the materials for problems A and B and build the LaTeX file with a PDF

Limitations

  • The skill, README and rules are written in Chinese, and the paper is Chinese by default. For MCM/ICM the Chinese draft is finished first and then translated.
  • PDF output needs an installed TeX distribution with XeLaTeX. Without it the agent delivers `论文.tex` without a compile check.
  • The recognized text of the winning papers is produced automatically and formulas and indices can contain errors. Treat the original PDFs as the reference.
  • The honesty of the content rests with the participant: the skill supplies writing rules and does not guarantee the model is correct.

How to disable. Delete the `cumcm-paper-hand-skill` directory from `~/.claude/skills/` or from the project's `.claude/skills/` and start a new session. Only the paper files created in the `论文/` directory stay in the participant's folder.

FAQ

How do I install cumcm-paper-hand-skill in Claude Code?

Clone the repository and copy the nested folder: `cp -r cumcm-paper-hand-skill/skills/cumcm-paper-hand-skill ~/.claude/skills/`. For one project copy it to `.claude/skills/`. Then check with `/skills` that the skill is visible.

What should the participant folder look like?

You need `题目/` with the problem statements, `问题A/`, `问题B/` and so on with `建模笔记.md`, `代码/` and `结果/`, plus `论文/` for the output. A sample is given in the `目录结构模板.md` template.

Does the skill build the model for me?

No, if the materials already exist: it takes the finished solution. To rebuild a model you must say so explicitly, and then the agent runs the full cycle from `建模流程.md`.

Does the skill fit the MCM/ICM contest?

Yes, it is declared for the American contest. The order is a Chinese version first, then an English translation. The project has no English template, so you add it to the rules or to `论文模板.tex`.

Can I add my own winning papers?

Yes. Put the PDF in `ref/`, run `scripts/ocr_pdfs.py` for scans without a text layer and update `ref/README.md`. The agent then uses them as samples of structure and layout.

Discussion

No questions or reviews yet.

Skills

A skill that reviews a CUMCM competition paper against the problem, scores five dimensions and gives an unofficial award forecast.

SkillMinimal access104Repository stars

Meta-model-agent takes a mathematical modeling task through seven stages: data, model, computation, figures and paper.

SkillMinimal access112Repository stars

Eight skills for LaTeX research papers, from topic to compiled PDF, with verified BibTeX citations and gated steps

SkillExtended access275Repository stars

A Claude Code skill for research papers: a five-stage pipeline, section rules, a style audit and an independent red-team review.

SkillMinimal access249Repository stars

Skill with 30 prompt templates for research papers in English and Chinese, from literature review to grant proposals

SkillMinimal access553Repository stars

A skill that drafts an ML paper after the patterns of CVPR, ICCV and NeurIPS best papers and draws its figures and schemes.

SkillMinimal access359Repository stars

README in short

The page describes the skill's purpose, installation by copying a folder and the participant's working folder. It then lists the repository structure, paper writing rules, how to use the winning papers and a table of places where the skill can be customized.

README badge

Original SKILL.md

---
name: cumcm-paper-hand-skill
description: 数学建模竞赛(CUMCM 国赛 / MCM/ICM 美赛)建模分析与论文写作技能。在参赛者整理好的参赛文件夹(题目/、问题X/建模笔记.md、代码/、结果/)中完成建模、求解与论文撰写,最终以 LaTeX 交付(论文.tex + 编译 PDF)。Use when 用户提到"数学建模"、"建模比赛"、"数模论文"、"数学建模竞赛"、"建模分析"、"建模求解"、"写数模论文"、"帮我做这道建模题"、"帮我写论文"、"优秀论文参考"、"论文写作指导"或类似表述。
---

# 数学建模竞赛论文写作技能

在参赛文件夹内三步工作:**摸底 → 核对材料 → 写论文(LaTeX 交付)**。

## When to Use / When NOT to Use

- **Use when**:用户要在参赛文件夹中建模、求解或撰写数模论文,或要求参考获奖论文([ref/](ref/) 内置)学习论文写法。
- **NOT use when**:用户只需要算法概念解释或通用数学知识问答;用户明确指定使用其他建模 skill。

## 输入:参赛文件夹结构

参赛者把**原始题目、每题的建模和解答**分文件夹整理,结构见 [templates/目录结构模板.md](templates/目录结构模板.md);未整理时按该模板补齐或按现有文件归拢。要点:

- `题目/`:原始题目与附件,**只读,不得修改**;
- `问题X/建模笔记.md` + `代码/` + `结果/`:本题建模过程与产物,论文素材来源;
- `论文/`:输出 `论文.tex`、`论文.pdf`、附图。

## 工作流程

### Step 1 摸底

1. 读取 `README.md` 与文件夹结构,列出全部题目、数据、已有笔记。
2. 读取 `题目/` 原始题目,逐问标注:研究对象、已知条件、核心矛盾、每问任务。
3. 检查每题 `建模笔记.md`,缺失的先补齐。
4. 浏览 [ref/README.md](ref/README.md),选定与本题类型相近的 1–2 篇参考论文。

**出口标准**:题目逐问理解完毕,每题有笔记或补齐方案,参考论文已选定。

### Step 2 核对建模与求解材料

**已存在的建模/求解,不得重新建模或重新求解**——直接采用。逐题检查:

1. 有完整 `建模笔记.md` + `结果/` → 直接采用,进 Step 3。
2. 有代码与结果、笔记缺失 → 只补齐笔记(记录已有事实),进 Step 3。
3. 有笔记、无结果 → 向参赛者确认是否补求解;补完在交付说明注明"本次新增求解:…"。
4. 仅当**用户明确要求**重新建模/求解时,执行 [references/建模流程.md](references/建模流程.md) 的完整闭环。

**出口标准**:未做任何未经说明的建模/求解;下一问输入已明确。

### Step 3 撰写论文(LaTeX 交付)

Report a problem