yjh051108/mmkit/comp-paper-en
Claude Code and agent skill by yjh051108/mmkit
- community
Checking that the SKILL.md file is still in the repository.
Mathematical modeling competition paper writing in English (MCM/ICM/APMCM) — LaTeX (PDF mode) or Markdown (docx mode). Generate complete paper following COMAP format. Use when user says \"write MCM paper\", \"美赛论文\", \"English competition paper\".
Install
npx vskill@latest install yjh051108/mmkit/comp-paper-enSKILL.md
Competition Paper Writing (English)
Write a competition paper: $ARGUMENTS
Constants
- COMPETITION — Default
mcm. From Additional Parameters. - MAX_PAGES — Default 25. Body pages must be ≥ MAX_PAGES.
- CUSTOM_REQUIREMENTS
Inputs
- PROBLEM_ANALYSIS.md, MODELING_REPORT.md, RESULTS.md
- figures/, code/
Load shared rules
MCM/ICM Paper Structure
⛔⛔⛔ Output Contract (highest priority)
Mandatory output depends on `params.output_format`:
- PDF mode:
paper/main.tex(≥ 5KB) +paper/sections/*.tex+paper/references.bib - docx mode:
paper/main.md(single file, ≥ 5KB). Do NOT createpaper/main.tex. Readreferences/docx-conventions.mdin this skill for the Markdown conventions.
⛔ MUST run output verification before ending the step:
Workflow
Step 0: Backup + resume check
Back up existing paper/. Check for incomplete sections:
Resume: only write placeholder sections, skip completed ones (>2000 chars). Save each section immediately. If approaching output limit, create % [PLACEHOLDER] files.
Step 1: Select template
MCM/ICM uses mcmthesis.cls (included in template folder). APMCM uses article class.
⛔ Do not write main.tex from scratch — copy the template and only replace placeholders. The template handles fonts, margins, headers, and formatting.
Step 2: Figure inventory
Before writing any section, build a complete inventory of available figures:
⛔ MANDATORY: Build a FIGURE EMBEDDING PLAN before writing any section:
Rules:
- ⛔ Must use figure blocks from `latex_includes.tex`, not write
\includegraphicsfrom scratch - ⛔ TikZ diagrams must be embedded: every
\begin{figure}block inlatex_includes.texthat referencestikz_diagrams.pdf/tikz_*.pdfmust be copied into a section — do not miss any - ⛔ Image paths must be `../figures/xxx.pdf`
- Only embed figures whose PDF files actually exist
⛔⛔⛔ DrawIO figure embedding (most commonly missed — check each one):
DrawIO figures (roadmap, flow charts, pipeline diagrams) are appended at the end of latex_includes.tex by the paper-figure step. You MUST embed them:
| DrawIO figure type | Embed location | Section file | |
|---|---|---|---|
| Technical roadmap (fig_roadmap) | End of Introduction/Problem Restatement | 1_introduction.tex | |
| Sub-problem flow chart (fig_flow_q1/q2/q3) | Inside each sub-problem's "Model Construction" subsection, preceded by 2-3 sentences introducing the solving approach and main steps | 4_problem1.tex, 5_problem2.tex etc. | |
| Data pipeline (fig_pipeline) | Data preprocessing section | Data/method section | |
| TikZ geometry/algorithm (tikz_diagrams.pdf) | Geometry → relevant sub-problem section; algorithm flow → Model Construction subsection | Sub-problem/Model section |
After writing all sections, verify DrawIO/TikZ figures are embedded:
Also scan figures/*.tex for all \begin{figure} / \begin{table} blocks with their \label{}. After writing, verify all embedded:
Follow interleaving and embedding rules from _utils/writing_rules.md.
⛔ Figure-text interleaving hard rules (every section must follow):
- All
\begin{figure}must use[H], never[htbp] - Every figure/table must be followed by ≥5 lines of analysis text (data interpretation + comparison + conclusion) before the next figure
- Absolutely no consecutive figures/tables without analysis paragraphs between them
- Use
\includegraphics[width=0.85\textwidth,keepaspectratio](width-driven, let height auto-scale). ⛔ Do NOT add a smallheight=0.38\textheightcap — withkeepaspectratio, a height cap can only shrink the figure: near-square or tall figures (heatmaps, radar charts, forest plots, confusion matrices, stacked subplots, flowcharts) get clamped to ~half text-width and look tiny. Only addheight=0.9\textheightas an overflow guard when a single figure is genuinely near a full page tall
Step 2.5: Pre-fetch verified reference pool
⛔ MUST complete before writing any \citep{} in Step 3.
Create _tmp/_verified_refs.txt with verified papers. Only cite papers from this pool when writing. Search and verify before adding new citations.
Fallback: If scholar_fetch.py returns no results or match_label="low" for a topic, use WebSearch to find the paper on Google Scholar / Semantic Scholar website, then manually verify title + authors + year before adding to the pool.
Step 3: Write each section
⛔ MCM/ICM chapter order (must follow template):
File names must match template \input{sections/...} lines.
⛔ Before writing each section, read MODELING_REPORT.md and RESULTS.md for exact numbers and formulas.
⛔ No `\begin{itemize}` or `\begin{enumerate}` in body text — use flowing prose. Inline numbering "(1)...(2)..." is acceptable.
<exemplar_depth>
Writing depth reference
MCM/ICM Outstanding Paper (25 pages total, including everything):
- Summary Sheet (1p): 300-400 words, self-contained with specific numerical results. Structure: problem statement (1-2 sentences) → method (2-3 sentences) → key results (3-4 sentences with numbers) → conclusion (1-2 sentences)
- Introduction (2p): problem context + literature + approach overview
- Assumptions (0.5p): each assumption with justification (not just a bullet list)
- Notations (0.5p): use non-floating table (
\begin{center}\begin{tabular}+\captionof{table}{}, NOT\begin{table}). This prevents the section title and table from being split across pages. Keep to 15-20 symbols max. - Each sub-problem (4-5p): model formulation (1.5p, with derivation) + solution method (1p, with algorithm) + results with table+figure+numbers (1p) + analysis (0.5-1p, interpretation + comparison)
- Sensitivity Analysis (2-3p): ≥2 key parameters, each with variation plot + analysis paragraph
- Model Evaluation (1.5p): 3-5 strengths + 2-3 weaknesses (honest, not token weaknesses) + generalization discussion
- References + Appendix (3-4p)
APMCM First Prize (25-30 pages): similar but can be longer, 5-6 pages per sub-problem with more detailed analysis. </exemplar_depth>
After each chapter, check chars:
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/comp-paper-en/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/yjh051108/mmkit/comp-paper-en)