Agent skill

Model Assumptions Builder

by zhnnky329 in zhnnky329/MathModeling-skills

Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact…

MITAuto-check passed

Install Model Assumptions Builder

skills CLI
$ npx skills add zhnnky329/MathModeling-skills --skill model-assumptions-builder -a claude-code

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

GitHub CLI
$ gh skill install zhnnky329/MathModeling-skills model-assumptions-builder --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/zhnnky329/MathModeling-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/model-assumptions-builder .claude/skills/model-assumptions-builder && 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
model-assumptions-builder
GitHub stars
1.1k
Token cost
~496 tokens
SKILL.md length
210 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
MIT

At a glance

Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact…

  • Works in 7 steps: Extract explicit problem assumptions and… → Remove filler statements that do not… → For each assumption record → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Model Assumptions Builder is an agent skill from zhnnky329/MathModeling-skills. Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact judgments to the human modeler.

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

The repository describes itself as: 面向数学建模竞赛的 Claude Code / Codex Skills ,支持分阶段建模流程与 Python、MATLAB/北太天元代码分支。 The licence is MIT.

Example prompts

  • “/model-assumptions-builder”

Workflow steps

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

  1. Extract explicit problem assumptions and method-induced assumptions.
  2. Remove filler statements that do not affect model validity or interpretation.
  3. For each assumption record
  4. Identify conflicts across Qx.
  5. Present unresolved necessity/impact trade-offs in one compact choice card where possible.
  6. Log human assumption_necessity decisions in qx_decisions.jsonl.
  7. Save planning/model_assumptions.md, transcribing settled human labels and impacts with decision IDs.

What it can do on your machine

Read from SKILL.md and the folder at commit 0b46e9c. 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

Model Assumptions Builder loads about 496 tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 210 words of instructions outside code blocks.

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

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 zhnnky329/MathModeling-skills at commit 0b46e9c, republished under its MIT licence (© zhnnky329). 210 words, ~496 tokens.

Download SKILL.mdSave it as .claude/skills/model-assumptions-builder/SKILL.md (or your agent's skills folder).
name
model-assumptions-builder
description
Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact judgments to the human modeler.

Inputs

  • problem parse;
  • active method cards;
  • data profile and risk-probe summaries;
  • question dependency map;
  • existing assumptions and human decisions.

Read legacy candidate pools only during migration.

Workflow

  1. Extract explicit problem assumptions and method-induced assumptions.
  2. Remove filler statements that do not affect model validity or interpretation.
  3. For each assumption record:
    • scope and source;
    • modeling need;
    • applicable method/Qx;
    • validation evidence;
    • mitigation or fallback link.
  4. Identify conflicts across Qx.
  5. Present unresolved necessity/impact trade-offs in one compact choice card where possible.
  6. Log human assumption_necessity decisions in qx_decisions.jsonl.
  7. Save planning/model_assumptions.md, transcribing settled human labels and impacts with decision IDs.

Assumption Fields

  • ID;
  • statement;
  • scope;
  • source and modeling need;
  • human-confirmed type: necessary or simplifying;
  • validation method/evidence;
  • impact if violated;
  • mitigation/fallback;
  • decision ID.

Rules

  • Do not invent generic assumptions such as “data are accurate” unless they affect a real dependency.
  • Do not finalize necessary/simplifying or impact judgments for the human.
  • Do not leave many repeated sentinels in the final file; collect missing judgments through a choice card and stop finalization until answered.
  • Revisit an assumption only when its method, evidence, or downstream use materially changes.

Verification

  • Every assumption has a modeling need and source.
  • Human-owned labels trace to decisions.
  • Probe/robustness evidence addresses load-bearing assumptions.
  • Cross-Qx conflicts are resolved or explicit.

© zhnnky329, 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 .codex/skills/model-assumptions-builder of zhnnky329/MathModeling-skills.

Open the folder on GitHubat commit 0b46e9c

Compare with similar skills

Model Assumptions Builder 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.

Model Assumptions Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Model Assumptions Builder this skillzhnnky329/MathModeling-skills1.1k—~496Automated safety check: PassMIT
Java Refactoring Extract Methodgithub/awesome-copilot40k1 repos~873Automated safety check: PassMIT
Extractalirezarezvani/claude-skills28k—~1.4kAutomated safety check: PassMIT
Wiki Maintaineropenclaw/openclaw392k1 repos~462Automated safety check: PassMIT
Obsidian Vault Maintaineropenclaw/openclaw392k1 repos~262Automated safety check: PassMIT
Openclaw PR Maintaineropenclaw/openclaw392k—~2.3kAutomated safety check: PassMIT

Similar skills

  • Java Refactoring Extract Method

    github/awesome-copilot

    Official

    Refactoring using Extract Methods in Java Language. An agent skill from github/awesome-copilot.

    40k GitHub starsUsed in 1 repo~873 tokens
    DevelopmentAuto-check passed
  • Extract

    alirezarezvani/claude-skills

    Turn a proven pattern or debugging solution into a standalone reusable skill with SKILL.md, reference docs, and examples.

    28k GitHub stars~1.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Wiki Maintainer

    openclaw/openclaw

    Maintain the OpenClaw memory wiki vault with deterministic pages, managed blocks, and source-backed updates.

    392k GitHub starsUsed in 1 repo~462 tokens
    Knowledge ManagementAuto-check passed
  • Obsidian Vault Maintainer

    openclaw/openclaw

    Maintain an Obsidian-friendly memory wiki vault with wikilinks, frontmatter, and official Obsidian CLI awareness.

    392k GitHub starsUsed in 1 repo~262 tokens
    Knowledge ManagementAuto-check passed
  • Openclaw PR Maintainer

    openclaw/openclaw

    Review, triage, repair, or land OpenClaw issues and pull requests with current-source evidence and the native maintainer workflow.

    392k GitHub stars~2.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Brand Extract

    nexu-io/open-design

    Extract a complete Brand Kit from a live website by driving the in-app browser.

    100k GitHub stars~3.1k tokensUpdated today
    Productivity & AutomationAuto-check passed

More from zhnnky329/MathModeling-skills

All 29 skills in this repo
  • Method Selector

    zhnnky329/MathModeling-skills

    Build and risk-screen a compact role-based method shortlist for a mathematical-modeling subquestion.

    1.1k GitHub stars~1.6k tokensUpdated 16 days ago
    Auto-check passed
  • Problem Classifier

    zhnnky329/MathModeling-skills

    Classify each parsed mathematical-modeling subquestion by required output and structure, surface ambiguous framing trade-offs for human choice, and record primary/secondary task types without…

    1.1k GitHub stars~611 tokensUpdated 16 days ago
    Auto-check passed
  • Data Auditor Cleaner

    zhnnky329/MathModeling-skills

    Map contest attachments to subquestions, audit and clean raw data, and emit one reusable data profile with quality, coverage, imbalance, concentration, and method-readiness evidence for downstream…

    1.1k GitHub stars~1.1k tokensUpdated 16 days ago
    Auto-check passed
  • Decision Prompt Builder

    zhnnky329/MathModeling-skills

    Build one compact choice card at a genuine mathematical-modeling judgment point.

    1.1k GitHub stars~837 tokensUpdated 16 days ago
    Auto-check passed
  • Matlab Model Code Generator

    zhnnky329/MathModeling-skills

    Generate and run minimal reproducible MATLAB or Beita Tianyuan compatible code for the human-approved main method and usable baseline, with compact experiment artifacts and a canonical run summary.

    1.1k GitHub stars~685 tokensUpdated 16 days ago
    Auto-check passed
  • Model Code Analyzer

    zhnnky329/MathModeling-skills

    Translate a human-approved main method and usable baseline into a minimal language-neutral implementation and experiment contract.

    1.1k GitHub stars~881 tokensUpdated 16 days ago
    Auto-check passed

Questions about Model Assumptions Builder

What does Model Assumptions Builder do?

Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact…. Model Assumptions Builder is an agent skill from zhnnky329/MathModeling-skills. Extract and maintain global and method-specific mathematical-model assumptions from the problem frame, active method cards, data profile, and risk probes, while leaving necessity and impact judgments to the human modeler.

How do I install Model Assumptions Builder in Claude Code?

Run `npx skills add zhnnky329/MathModeling-skills --skill model-assumptions-builder -a claude-code`. Or copy the skill folder (.codex/skills/model-assumptions-builder in zhnnky329/MathModeling-skills) into .claude/skills/model-assumptions-builder in your project. Claude Code loads it when a task matches its description.

How do I install Model Assumptions Builder in Codex?

Run `npx skills add zhnnky329/MathModeling-skills --skill model-assumptions-builder -a codex`. Or copy the skill folder (.codex/skills/model-assumptions-builder in zhnnky329/MathModeling-skills) into .agents/skills/model-assumptions-builder in your project. Codex loads it when a task matches its description.

Can I use Model Assumptions Builder 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 zhnnky329/MathModeling-skills --skill model-assumptions-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/model-assumptions-builder, .gemini/skills/model-assumptions-builder, .github/skills/model-assumptions-builder and .opencode/skills/model-assumptions-builder in your project.

What does Model Assumptions Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Model Assumptions Builder is instructions for the agent only.

Does Model Assumptions Builder 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 Model Assumptions Builder 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 Model Assumptions Builder use?

Model Assumptions Builder 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 Model Assumptions Builder use?

About 496 tokens (SKILL.md is roughly 2k 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 Model Assumptions Builder?

Skills that share tags, products or a category with Model Assumptions Builder: Java Refactoring Extract Method (github/awesome-copilot, 40k stars), Extract (alirezarezvani/claude-skills, 28k stars), Wiki Maintainer (openclaw/openclaw, 392k stars) and Obsidian Vault Maintainer (openclaw/openclaw, 392k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Model Assumptions Builder?

zhnnky329 (a GitHub user) maintains it in zhnnky329/MathModeling-skills, which has 1,060 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on September 24, 2026.

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