К основному содержанию
скилл CX Codex

modelviz-skill — скилл для Claude Code: графики из таблиц

Скилл modelviz-skill для Claude Code строит научные графики по таблицам и запросу на естественном языке. Он выбирает шаблон, подгоняет его под данные и проверяет результат.

Apache-2.0 ★ 108 обновлён 2026-11-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill modelviz-skill -a claude-code
Открыть на GitHub

Что делает modelviz-skill

modelviz-skill превращает данные пользователя в научный график: выбирает шаблон из каталога, адаптирует его Python-код, запускает скрипт и проверяет изображение. Поддерживаются файлы csv, xlsx и xls; для Excel можно задать sheet_name. Готовый результат включает график, код, список зависимостей и отчёты о проверках.

Для работы нужны данные и чат-модель либо запускаемый макет, способные возвращать структурированный вывод. Скилл проверяет зависимости Python и при необходимости устанавливает их. Если запрос неоднозначен, нужный лист не выбран, данные не подходят или шаблон не найден, он задаёт уточняющий вопрос. Исходные шаблоны и файлы данных не меняются; без подходящего шаблона построение останавливается.

Какие задачи решает

  • построить научный график по данным csv, xlsx или xls
  • подобрать шаблон из каталога под запрос на естественном языке
  • адаптировать Python-шаблон, не меняя его оригинал
  • проверить изображение и исправить явные проблемы

Примеры запросов агенту

  • Построй научный график по данным results.xlsx в сдержанном стиле.
  • Выбери шаблон для сравнения показателей из data.csv и подготовь график для отчёта.
  • Построй график по листу Results из model.xlsx и проверь готовое изображение.

Как установить modelviz-skill

1Через Skills CLI (Vercel)

npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill modelviz-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/modelviz/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/modelviz/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о modelviz-skill

Как установить modelviz-skill в Claude Code?

Выполни npx skills add cjh-solver/MathModeling-Skills-Arsenal --skill modelviz-skill -a claude-code. Файл скилла находится по пути ~/.claude/skills/modelviz/SKILL.md.

Что делает modelviz-skill?

Он выбирает научный шаблон для пользовательских данных, адаптирует Python-код, строит график и проверяет изображение. Поддерживает csv, xlsx и xls.

Что нужно для работы modelviz-skill?

Нужен файл данных и чат-модель либо запускаемый макет, способные выдавать структурированный вывод. Скилл также проверяет и устанавливает зависимости Python.

Исходный текст

SKILL.md · Apache-2.0
---
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.

## Contest-Orchestrator Adapter

When invoked from `contest-orchestrator`, this skill owns the ModelViz generation phase for data-result figures only. It consumes an approved decision card from SciPilot and performs template candidate retrieval, real-data adaptation, execution and format export. Do not create problem-analysis flowcharts, technical-roadmap diagrams, mechanism schematics or geometry figures here; route those to their registered diagram generators.

- Keep the result source, selected template, adapted script, generated files and quality reports under the project workspace.
- Require the approved decision card, result source and data-field mapping before generation. ModelViz must not redefine the claim, recommended chart type or paper location recorded in the card.
- Export exactly `SVG` and `PNG`; SVG is the formal LaTeX insertion source and PNG is the preview/visual-QA source. ModelViz does not produce PDF image files.
- Hand generated SVG and PNG, the adapted script and the execution report to the following SciPilot QA phase. Final semantic check, technical check and visual check are owned by SciPilot; ModelViz must not replace that phase with a ModelViz-only verdict. Standalone ModelViz figure generation keeps visual QA enabled by default and reviews a rendered preview; the orchestrated route disables only this duplicate local check because SciPilot is the single QA owner.
- Register the figure as `generator=modelviz` after QA and `semantic_qa=scipilot-figure-skill`; do not use a generic fallback generator.
- Do not modify original templates, source data, model files or result files.
- A missing decision card, source mapping, unsupported column, failed execution, blank/corrupt output, missing SVG/PNG, or any image PDF blocks paper use.
- Return the shared node handoff fields: `status`, `active_mode`, `task_card`, `artifacts`, `evidence`, `checks`, `blockers`, and `next_node`.
- Bind every visible number, label, unit and caption claim to the registered result or source. Do not put agent discussion, review messages, debugging, failed attempts or other negative echo into the figure, caption or report.

## 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`

The successful template-adaptation result includes `template_provenance`: the selected
`template_id`, source path, and SHA-256 of the source bytes used for adaptation. Pass these
fields to the contest figure registry; the hash identifies the template, not the generated figure.

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: `workspace/adaptation_plan.json`

Code generation:

- Prompt: `src/prompts/template_code_adapter.py`
- Schema: `src/schemas/adaptation_result.py`
- Outputs: `workspace/adaptation_result.json`, `workspace/adapted_plot.py`

The model must preserve core template layout, plotting library, color style, axes/legend conventions, and report structure where possible. It must replace template demo data with real data from the user file and use only real column names.

Python validation rejects:

- Nonexistent data columns.
- Dependencies not confirmed available.
- Empty `adapted_code`.
- Attempts to save into `templates/`.

Original templates under `templates/` are read-only. Do not edit or overwrite user data.

If the code model requests additional dependencies, the current pipeline allows one extra installation pass through `install_python_dependencies`. If that fails, stop.

### 6. Execute the Adapted Script

`run_template_adaptation_pipeline` saves and executes the script with:

- Tool: `save_adapted_script`
- Tool: `execute_plot_script`
- Script: `workspace/adapted_plot.py`
- Output directory: `outputs`
- Execution report: `workspace/execution_result.json`

`execute_plot_script` uses `subprocess.run([...], shell=False)`, passes the data path and output directory as arguments, sets `DATA_PATH` and `OUTPUT_DIR`, captures stdout/stderr, and records generated files.

Stop if the script times out, the user data path does not exist, the script fails, or no output file is generated.

### 7. Run Output Preflight and Handoff to SciPilot QA

Use `src.services.plot_quality_pipeline.run_plot_quality_pipeline`.

Technical tools:

- `execute_plot_script`
- `validate_output_artifacts`
- `inspect_generated_image`
- `collect_plot_warnings`

Output preflight outputs:

- `workspace/technical_quality_report.json`
- `workspace/execution_result.json`

Checks include output location, extension, exact SVG/PNG pair, image size, missing files, PNG readability, image dimensions, pixel variance, near-blank risk, Python runtime errors, dependency errors, font warnings, layout warnings, legend warnings, data warnings, and save failures. Any PDF image output is a failure.

In the `contest-orchestrator` route, set `enable_visual_qa=False` for this service and hand the artifacts to SciPilot. A standalone ModelViz invocation may keep its local visual-QA option when the caller explicitly requests it.

### 8. SciPilot QA Handoff

SciPilot receives the approved decision card, generated SVG/PNG, adapted script, execution report and output preflight report. It performs the final semantic check, technical check and visual check, with visual checking enabled by default for figure generation. A failed check returns a targeted repair request to ModelViz; only a passed QA package proceeds to the registry.

### 9. Repair Only Clear Problems

If output preflight or the following SciPilot QA report requires repair, ModelViz performs only the named localized repair and returns the artifact pair to SciPilot:

- Prompt: `src/prompts/plot_code_repair.py`
- Schema: `src/schemas/repair_result.py`
- Backups: `workspace/repair_versions/adapted_plot_v{n}.py`
- History: `workspace/repair_history.json`
- Final report: `workspace/final_quality_report.json` for standalone ModelViz use

Repair rules:

- Fix only issues named in the technical or visual reports.
- Do not redesign the chart from scratch.
- Do not modify `templates/` or user data.
- Preserve data meaning and template style.
- Prefer existing dependencies and plotting logic.
- New dependencies must go through `install_python_dependencies`.

Limits:

- `max_repair_attempts=3`
- `max_dependency_install_rounds=2`

Stop when all checks pass, maximum repairs are reached, the same issues repeat, repaired code is unchanged, dependency-install rounds are exhausted, dependency installation fails, the model returns `can_retry=false`, or user data cannot satisfy the requirement.

## Prompt Files

Use the Python `ChatPromptTemplate` modules as the executable prompt sources:

- `src/prompts/requirement_parser.py`
- `src/prompts/final_template_selector.py`
- `src/prompts/template_adaptation_plan.py`
- `src/prompts/template_code_adapter.py`
- `src/prompts/visual_quality_checker.py`
- `src/prompts/plot_code_repair.py`

Markdown prompt notes exist at `prompts/template_adaptation.md`, `prompts/visual_quality_check.md`, and `prompts/code_repair.md`. Treat them as supporting references, not a second execution path.

## Files and Outputs

Write intermediate JSON to `workspace/` using UTF-8 and unescaped Chinese. Write final chart files to `outputs/`. Keep debug logs separate from final JSON reports. Do not claim a file exists until the path has been created and checked.

Typical outputs:

- `outputs/chart.svg`
- `outputs/chart.png`
- `workspace/user_requirement.json`
- `workspace/candidate_templates.json`
- `workspace/dataset_context.json`
- `workspace/final_template_selection.json`
- `workspace/dependency_report.json`
- `workspace/dependency_install_result.json`
- `workspace/requirements.generated.txt`
- `workspace/adaptation_plan.json`
- `workspace/adaptation_result.json`
- `workspace/adapted_plot.py`
- `workspace/execution_result.json`
- `workspace/technical_quality_report.json`
- `workspace/visual_quality_report.json`
- `workspace/repair_history.json`
- `workspace/final_quality_report.json`
- `outputs/chart.svg`
- `outputs/chart.png`

## Failure Handling

Return a structured failure with the failed stage, `error_type`, message, details, and suggestion when possible. Stop rather than pretending success for:

- Missing or invalid `user_requirement.json`, `template_catalog.yaml`, candidate file, final selection file, template source, or user data file.
- Unsupported data format or missing Excel sheet.
- Ambiguous requirement not yet clarified.
- Empty candidate list.
- Model output outside schema.
- Model-selected template outside candidates.
- Model-created data columns.
- Unmapped or uninstalled key dependencies.
- Illegal package names or failed dependency installation.
- Empty or unsafe adapted code.
- Script timeout or failure.
- Missing, corrupt, or blank output image.
- Visual model failure when visual checking is required.
- Maximum repair attempts reached.

## Current Limitations

- The final workflow requires caller-supplied structured-output model objects; tests use mock runnables.
- Visual inspection quality depends on giving the visual model the actual image content, not only the path string.
- `README.md`, `pyproject.toml`, and `scripts/` are not present; use the Python service entry points directly.
- The older recommendation pipeline (`run_template_matching_pipeline`) still exists for compatibility, but the Skill flow should use `run_candidate_matching_pipeline` and `candidate_templates.json`.

© cjh-solver · Apache-2.0 · cjh-solver/MathModeling-Skills-Arsenal

Похожие скиллы

Все скиллы по теме «Наука и исследования» →
csv-excel-merger OneWave-AI Скилл csv-excel-merger складывает несколько CSV, TSV и Excel в один файл: склеивает, джойнит по ключу, убирает дубли и проверяет арифметику строк. CX Codex +1 1 200установок Skywork Excel SkyworkAI Скилл Skywork Excel для Claude Code создаёт и анализирует таблицы Excel, строит графики и сводные отчёты через бэкенд Skywork. Создаёт финмодели и конвертирует PDF в таблицы. CX Codex +1 370установок excel sundial-org Позволяет агенту читать, создавать и форматировать таблицы Excel через скрипт на базе openpyxl. CX Codex +1 294установок data-analysis-skill podo Скилл data-analysis-skill разбирает Excel и CSV, подключает субагентов для параллельного анализа и собирает интерактивный HTML-отчёт. По запросу он экспортирует результат в PowerPoint. CX Codex +1 205установок tabular-cleanup gaasher Скилл tabular-cleanup приводит грязные CSV, TSV, Parquet, Excel или JSON-таблицы к согласованному контракту данных. Подходит для автономной очистки с проверками и журналом изменений. CX Codex +1 ★ 185звёзд репо alibabacloud-quickbi-smartq aliyun Скилл alibabacloud-quickbi-smartq направляет запросы к данным в нужный модуль Quick BI: от вопросов по таблицам до разбора документов и подготовки отчётов. CX Codex +1 141установок

Из того же набора10

Весь набор →
code_repair Промпт code_repair для Claude Code исправляет проблемы из технических и визуальных отчётов. Он сохраняет текущий подход к построению графиков и зависимости. GP ChatGPT ★ 108звёзд репо visual_quality_check Промпт visual_quality_check для Claude Code сверяет сгенерированный график с требованиями задачи, выбранным шаблоном и отчётом. Фиксирует только дефекты с самого изображения или из отчётов. GP ChatGPT ★ 108звёзд репо template_adaptation Промпт template_adaptation для Claude Code переносит реальные данные в выбранный шаблон. Он сохраняет исходное оформление и структуру там, где это возможно. GP ChatGPT ★ 108звёзд репо markitdown-skill Скилл markitdown-skill для Claude Code переводит документы и веб-страницы в Markdown через CLI markitdown. Выполняет OCR изображений, транскрибирует аудио и пакетно обрабатывает папки. CX Codex +1 ★ 108звёзд репо bzd-review-paper Скилл bzd-review-paper для Claude Code оценивает статью по математическому моделированию и проверяет её соответствие условиям конкурса. Для разбора нужны полный текст задачи и статья команды. CX Codex +1 ★ 108звёзд репо tikz-scientific-figures Скилл tikz-scientific-figures для Claude Code рисует рисунки для статьи или отчёта на TikZ и PGFPlots и отдаёт SVG с PNG. Один рисунок — один standalone-файл .tex, и он остаётся редактируемым. CX Codex +1 ★ 108звёзд репо tech-route-maker Скилл tech-route-maker для Claude Code строит редактируемые схемы технических маршрутов и исследовательских пайплайнов по исходным материалам. Включается по запросу диаграммы или команде $tech-route-maker. CX Codex +1 ★ 108звёзд репо fireworks-tech-graph Скилл fireworks-tech-graph для Claude Code строит технические диаграммы и экспортирует их в SVG, PNG или интерактивный HTML. Запускается по просьбе визуализировать систему или инженерную идею; запрос на GIF включает анимацию. CX Codex +1 ★ 108звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой