What it does
AI科研skill可视化绘图:ModelViz 是一个面向建模与科研写作场景的可视化 Skill。项目内置上百个覆盖多种建模场景的高质量科研绘图模板,将不同功能的图表按统一类别和编号管理,并确保模板源码可独立运行、稳定输出图片。后续系统将通过结构化模板信息、数据特征分析与检索规则,根据用户上传的数据和自然语言需求,推荐适合的图表类型、字段映射与配色方案,再调用对应模板生成可复现的 PNG、SVG 或 PDF 图像。项目重点解决通用大模型直接生成绘图代码时风格不统一、运行不稳定、参数难复用等问题,强调模板驱动、配置清晰、结果可复现和科研表达规范。
- Connects Instruction files the AI reads
- Account or key Not confirmed yet (README not read yet)
- Category Coding
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/hrdzhu-modelviz-skill)Use together with
MCP servers that connect the AI to services for the same work
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Similar Skills
Same kind of work, ordered like the Skills list
| This one modelviz-skill | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Maker | hrdZhu | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub stars | 304 | 467,235 | 234,125 | 149,873 | 144,332 |
| Last code change | Jul 19, 2026 | Nov 18, 2026 | Apr 20, 2026 | Nov 18, 2026 | Nov 18, 2026 |
| License | – | MIT | – | Apache-2.0 | MIT |
1 skills (instruction sets) by hrdZhu that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Codex
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account hrdZhu (person) is only 4 months old: take extra care
- Use and upkeep
★ 304 stars, few users so far · code last changed Jul 19, 2026
- Any scripts?
157 scripts that can run on a computer: evals/__init__.py, evals/run_evaluation.py, examples/stage3_tool_choice_demo.py, examples/tool_choice_demo.py and 153 more
- Uses the internet?
Could not check every script (some are too large); read them first
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit cd9eac0 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Download from GitHub
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the modelviz-skill folder again. The ZIP must have a modelviz-skill folder with SKILL.md at the top level, no loose files
Open Skills on claude.ai and upload
+Create skillUpload a skillpick modelviz-skill.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /modelviz-skill or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
Restart Claude Code, then type /modelviz-skill or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the modelviz-skill folder at ~/.agents/skills/modelviz-skill
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
Restart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick modelviz-skill
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
In Cursor’s Agent chat, type / and pick modelviz-skill
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
Showing the first 8,000 characters · Open the full file on GitHub
---
name: modelviz-skill
description: Scientific visualization workflow for mathematical modeling competitions. Use when a user wants to turn their own CSV/XLSX/XLS data and a natural-language plotting request into a publication-style scientific figure by selecting from the existing template catalog, adapting the selected Python template without modifying originals, executing the plot, checking technical and visual quality, and repairing clear issues when needed.
---
# ModelViz Skill
Use this skill to create competition-report or paper-ready scientific visualizations from user data and the local template library. The workflow chooses an existing template, preserves its layout and style, adapts it to real data, runs the generated script, and returns the final chart, code, dependency list, and quality reports.
Do not use this skill for explaining math concepts without plotting, modifying user data, running arbitrary non-plotting code, or forcing an unsupported chart type when no suitable template exists.
## Inputs
- Natural-language plotting request from the user.
- User data file. Current code supports `csv`, `xlsx`, and `xls` through `src/tools/prepare_dataset_context.py`.
- Optional chart type, style, negative requirements, output preferences, and Excel `sheet_name`.
- A chat model or mock runnable capable of structured output for the LLM stages.
Ask a clarification question before continuing if the request is too vague, the required sheet is unclear, the data cannot support the request, no candidate template fits, or several columns have ambiguous meaning.
## Core Rule
Keep this responsibility split:
- Program code handles file I/O, Pydantic validation, deterministic candidate recall, data sampling facts, dependency inspection/check/install, script execution, artifact checks, image statistics, warning collection, repair limits, and JSON reports.
- The language model handles natural-language requirement parsing, semantic data interpretation, final template choice from candidates, template style understanding, column mapping, template code adaptation, visual judgment, and localized code repair.
Do not introduce an Agent, RAG, embeddings, or a vector database. Do not bypass tools by inventing files, installed dependencies, candidate templates, generated images, or quality status.
## Implementation Map
Catalog and workflow references:
- `docs/template_catalog.yaml`
- `docs/template_index.csv`
- `docs/stage5_stage6_skill_workflow.md`
Service entry files:
- `src/services/requirement_parser.py`
- `src/services/candidate_matching_pipeline.py`
- `src/services/final_template_selection_pipeline.py`
- `src/services/template_adaptation_pipeline.py`
- `src/services/plot_quality_pipeline.py`
Tool files used by the main flow:
- `src/tools/load_requirement.py`
- `src/tools/load_catalog.py`
- `src/tools/match_candidate_templates.py`
- `src/tools/rank_candidate_templates.py`
- `src/tools/save_candidate_templates.py`
- `src/tools/prepare_dataset_context.py`
- `src/tools/load_selected_template.py`
- `src/tools/inspect_template_dependencies.py`
- `src/tools/check_python_dependencies.py`
- `src/tools/install_python_dependencies.py`
- `src/tools/save_adapted_script.py`
- `src/tools/execute_plot_script.py`
- `src/tools/validate_output_artifacts.py`
- `src/tools/inspect_generated_image.py`
- `src/tools/collect_plot_warnings.py`
## Main Workflow
### 1. Parse User Requirement
Use `src.services.requirement_parser.parse_and_save_requirement`.
It combines:
- Prompt: `src/prompts/requirement_parser.py`
- Schema: `schemas/requirement_schema.py`
- Vocabulary: `docs/requirement_vocabulary.yaml`
- Output: `workspace/user_requirement.json`
The schema is `PlotRequirement` with fields `original_request`, `goal`, `functional_keywords`, `chart_types`, `style_keywords`, `use_case`, `negative_requirements`, `explicit_template`, `is_ambiguous`, and `clarification_question`.
Rules:
- Preserve `original_request`.
- If the user did not specify a chart type, keep `chart_types=[]`.
- Put style words such as `科研风`, `简洁`, and `低饱和` in `style_keywords`, not `functional_keywords`.
- Put exclusions such as `不要雷达图` or `不要三维` in `negative_requirements`.
- If `is_ambiguous=true`, ask `clarification_question` and stop before template recall.
### 2. Recall Candidate Templates
Use `src.services.candidate_matching_pipeline.run_candidate_matching_pipeline`.
It calls the stage-3 tools in this order:
1. `load_user_requirement`
2. `load_template_catalog`
3. `match_candidate_templates`
4. `rank_candidate_templates`
5. `save_candidate_templates`
Inputs:
- `workspace/user_requirement.json`
- `docs/template_catalog.yaml`
Output:
- `workspace/candidate_templates.json`
The template catalog currently contains 89 templates across 12 categories. Candidate recall is deterministic and does not read user data. Default `top_k=8`, and `top_k` is constrained to 5-10. `min_score` is constrained to 0-1.
Scoring in `src/tools/match_candidate_templates.py` prioritizes:
- Functional keyword matches against template keywords.
- Explicit chart type matches.
- Original user wording against template synonyms.
- Goal and use-case matches.
- Style matches with low weight.
- User negative requirements as exclusion.
- Template `negative_keywords` as penalties.
Do not treat the top candidate as the final answer. Stage 3 only recalls 5-10 plausible candidates.
### 3. Select Final Template With Data
Use `src.services.final_template_selection_pipeline.run_final_template_selection_pipeline`.
It combines:
- Data tool: `prepare_dataset_context`
- Prompt: `src/prompts/final_template_selector.py`
- Schema: `src/schemas/final_template_selection.py`
- Inputs: `workspace/user_requirement.json`, `workspace/candidate_templates.json`, and the user data file
- Outputs: `workspace/dataset_context.json`, `workspace/final_template_selection.json`
`prepare_dataset_context` only returns facts: file name, file type, sheet, row count, column count, real column names, head records, sampled records, sampling status, and warnings. It must not decide which chart is best.
The model must analyze the real data meaning and choose only from `candidate_templates.json`. Python validation then rejects:
- Template IDs outside the candidate list.
- Template names inconsistent with selected IDs.
- Data columns not present in the file.
- Missing `clarification_question` when `needs_clarification=true`.
If `selected_template_id` is null, stop and return the model's reason or question.
### 4. Inspect and Complete Template Dependencies
Use the first part of `src.services.template_adaptation_pipeline.run_template_adaptation_pipeline`.
It calls:
- `load_selected_template`
- `inspect_template_dependencies`
- `check_python_dependencies`
- `install_python_dependencies`
- `check_python_dependencies` again after initial install
Files:
- Catalog: `docs/template_catalog.yaml`
- Package mapping: `docs/package_name_mapping.yaml`
- Reports: `workspace/dependency_report.json`, `workspace/dependency_install_result.json`, `workspace/requirements.generated.txt`
Dependency rules:
- Inspect imports with Python AST and merge catalog `dependencies`.
- Convert submodules to top-level imports.
- Exclude standard-library modules and project-internal modules.
- Map known import names to pip package names using `docs/package_name_mapping.yaml`.
- Stop if required dependencies cannot be mapped.
- Install only validated ordinary package names with the current Python executable.
- Never execute installation commands from template code.
- Never use `shell=True`, `sudo`, URLs, Git addresses, local paths, or extra pip arguments.
- Do not overwrite project `requirements.txt`; write task dependencies to `workspace/requirements.generated.txt`.
### 5. Generate Adaptation Plan and Code
Continue with `run_template_adaptation_pipeline`.
Planning:
- Prompt: `src/prompts/template_adaptation_plan.py`
- Schema: `src/schemas/adaptation_plan.py`
- Output: `workspaceDiscussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 304
- Maker
- hrdZhu
- License
- No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
- Last code change
- Jul 19, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1
- Topics
- claude-code, codex, data-visualization, mathematical-modeling, scientific-visualization, skill