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

paperbanana — скилл для Claude Code: схемы и графики для статей

Скилл paperbanana для научных иллюстраций: превращает описание метода или PDF статьи в схему, график или разбор готовой картинки и выбирает самый лёгкий режим под задачу.

MIT 108 установок ★ 61 обновлён 2026-10-24

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

Что делает paperbanana

Скилл закрывает иллюстративную часть статьи: схемы методологии, графики по таблицам результатов, разбор уже готового рисунка. Первым делом он выбирает маршрут — самый лёгкий режим вместо полного многоагентного прогона.

Генерация идёт в два этапа. Сначала планирование: планировщик пишет описание схемы, стилист добавляет оформление площадки. Потом итеративное улучшение — визуализатор рисует картинку, критик правит описание. Флаг --iterations задаёт число проходов, --auto останавливает цикл, когда критика устраивает результат, --optimize включает подготовку входного текста. Режимы: plot для данных, generate для одной схемы, evaluate и polish для готового файла, batch и orchestrate для пачки.

Нужен Python 3.10+ и ключ провайдера. Схемам требуется ключ image-gen (OpenAI, Azure, Gemini, Atlas, OpenRouter), графикам хватает ключа VLM — поэтому график из CSV дешевле начать с plot. Ставьте в виртуальное окружение профилем под задачу: bash scripts/install.sh --profile diagram. Без ключа image-gen команда generate не нарисует ничего.

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

  • собрать схему метода из PDF статьи
  • нарисовать график по CSV без ключа к image-генератору
  • оценить готовый рисунок по эталону и понять, что чинить
  • довести существующую схему до стиля площадки
  • сгенерировать набор иллюстраций для всей статьи

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

  • Через paperbanana сделай схему метода из method.txt в стиле ICML
  • Построй график точности по results.csv
  • Оцени out.png относительно human.png и скажи, где расходится

Как установить paperbanana

1Через Skills CLI (Vercel)

npx skills add akillness/jeo-skills --skill paperbanana -a claude-code

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

~/.claude/skills/paperbanana/SKILL.md

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

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

Вопросы о paperbanana

Как установить paperbanana в Claude Code?

Выполните npx skills add akillness/jeo-skills --skill paperbanana -a claude-code. Скилл встанет в ~/.claude/skills/paperbanana/SKILL.md.

Что делает paperbanana?

Маршрутизирует работу с научными иллюстрациями: генерация схем, графики по данным, оценка и доработка готовых рисунков. Каждый раз выбирается самый лёгкий подходящий режим.

Нужен ли ключ API?

Для схем нужен ключ image-gen провайдера, для статистических графиков достаточно ключа VLM. Сам сервис требует Python 3.10+ и лучше работает в виртуальном окружении.

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

SKILL.md · MIT
---
name: paperbanana
description: >
  Route academic-figure work into the lightest workable PaperBanana mode instead of
  jumping straight to a full multi-agent generation run. Use when the user needs
  publication-quality methodology diagrams, statistical plots, figure evaluation,
  polishing an existing figure, batch/sweep generation, or a full-paper figure package
  from text or PDF. Even if the user does not say "paperbanana" — also triggers on:
  academic figure, methodology diagram, publication figure, generate diagram from paper,
  statistical plot from CSV, figure evaluation, polish figure, NeurIPS/ICML figure,
  arxiv illustration, plan-then-refine diagram pipeline.
allowed-tools: Bash Read Write Edit Glob Grep WebFetch
compatibility: Requires Python 3.10+ and works best in a virtual environment. Diagram generation needs an image-gen provider key (OpenAI/Azure/Gemini/Atlas/OpenRouter); statistical plots need only a VLM key. Studio, PDF, and MCP surfaces require extras.
license: MIT
metadata:
  tags: paperbanana, academic-figures, diagram-generation, statistical-plots, multi-agent, vlm-as-judge, mcp, cli, publication, python
  version: "1.0"
  source: https://github.com/llmsresearch/paperbanana
---

# paperbanana — routing-first academic illustration

> **Keyword**: `paperbanana` · `methodology diagram` · `statistical plot` · `figure evaluation` · `plan-then-refine`
>
> This is an unofficial community implementation of the PaperBanana paper (arXiv:2601.23265).
> Respect provider terms, API budgets, and each venue's figure/reuse policies.

PaperBanana turns text or a paper into publication-quality figures with a **two-phase,
multi-agent, plan-then-refine pipeline**. It is most useful when you choose the
**smallest workable mode** instead of always running the full generation loop:

- render data-driven charts with `plot` (matplotlib code, no image-gen key) before spending image credits
- fix an existing figure with `polish` or `evaluate` before regenerating from scratch
- generate a single diagram with `generate` before reaching for batch/sweep/orchestrate
- escalate iterations, candidates, and `--optimize` only on evidence, not by default
- route out to a vector editor, TikZ, or a human designer when generative figures are the wrong tool

## When to use this skill

- The user wants a methodology/architecture diagram from a `.txt`, `.md`, or `.pdf` and you must pick the lightest generation path
- The user has tabular results (CSV/JSON) and wants a chart — cheaper than a diagram because no image-gen provider is needed
- The user already has a figure and wants it judged (`evaluate`) or improved (`polish`) rather than re-created
- The user needs many figures (a manifest batch, a parameter sweep, or a whole-paper figure package)
- The user wants PaperBanana exposed to an agent/IDE via the MCP server or Claude Code skills
- The user keeps drifting toward hand-drawing every figure, hard-coding one provider, or maxing iterations/candidates and needs an honest route-out

## Instructions

### Step 1: Capture one intake packet before choosing a mode

Collect the minimum packet:

- **Artifact class**: a methodology diagram, a statistical plot, an existing figure to fix/judge, many figures, or a full-paper package
- **Source**: raw method text, a paper (`.pdf`/`.md`), a data file (CSV/JSON), or an existing image
- **Budget/keys**: which provider key is available (VLM-only vs image-gen), and any USD cap
- **Quality need**: quick draft vs auto-refine to critic satisfaction vs multi-candidate fan-out

Use this escalation ladder (smallest first):

1. Data → chart? Use `plot` / `plot-batch` (VLM-generated matplotlib, no image-gen key)
2. One diagram from text/PDF? Use `generate`
3. Have a figure already? Use `evaluate` (judge) or `polish` (guided edit), not a fresh run
4. Many diagrams/plots from a manifest? Use `batch` / `plot-batch`; sweep params with `sweep`
5. A whole paper's figure set? Use `orchestrate`
6. Generative figures are the wrong tool (exact vector art, trivial chart, brand-locked design)? Route out

Detailed packet examples and route-outs live in [references/intake-and-route-outs.md](references/intake-and-route-outs.md).

### Step 2: Install only the profile you need

Use a virtual environment unless the user explicitly wants a system install.

bash
bash scripts/install.sh --profile plot      # VLM-only: statistical plots
bash scripts/install.sh --profile diagram   # image-gen provider for diagrams
bash scripts/install.sh --profile pdf        # + PyMuPDF for PDF inputs
bash scripts/install.sh --profile studio     # + Gradio local web UI
bash scripts/install.sh --profile mcp        # MCP server surface
bash scripts/install.sh --profile all        # only when the full surface is truly needed


Then set exactly one provider key (`OPENAI_API_KEY`, `GOOGLE_API_KEY`, `ATLASCLOUD_API_KEY`, …).
Provider selection and config live in [references/providers-and-config.md](references/providers-and-config.md).

### Step 3: Understand the pipeline before turning knobs

Every diagram run is the same plan-then-refine loop, so tune stages instead of guessing flags:

- **Phase 0 — Input Optimization** (`--optimize`, optional): Context Enricher structures raw method text; Caption Sharpener tightens the caption. Two parallel VLM calls.
- **Phase 1 — Linear Planning**: Retriever picks reference examples → Planner writes a target description via in-context learning → Stylist applies venue aesthetics.
- **Phase 2 — Iterative Refinement**: Visualizer renders an image → Critic revises the description; repeat for `--iterations` (default 3) or until satisfied with `--auto`.

Full agent-by-agent detail lives in [references/pipeline-and-agents.md](references/pipeline-and-agents.md).

### Step 4: Run the lightest mode that fits

bash
# Cheapest: statistical plot from data (no image-gen key)
bash scripts/run.sh plot --data results.csv --intent "Bar chart of accuracy across benchmarks"

# Single methodology diagram from text
bash scripts/run.sh generate --input method.txt --caption "Overview of our framework"

# Add optimization + auto-refine ONLY when a plain run underdelivers
bash scripts/run.sh generate --input method.txt --caption "Overview" --optimize --auto


The full command surface (`generate`, `plot`, `batch`, `plot-batch`, `sweep`, `orchestrate`,
`composite`, `evaluate`, `polish`, `venues`, `studio`, `setup`, `data`) with flags lives in
[references/modes-and-cli.md](references/modes-and-cli.md).

### Step 5: Fix before you regenerate

When a figure already exists, do not rerun the whole pipeline:

bash
# Judge an existing figure against a human reference (VLM-as-Judge)
bash scripts/run.sh evaluate --generated out.png --reference human.png \
  --context method.txt --caption "Overview of our framework"

# Guided edit against a venue style guide (image-edit capable provider)
bash scripts/run.sh polish --input figure.png --venue icml --iterations 2


Evaluation dimensions (Faithfulness, Readability, Conciseness, Aesthetics) and venue style packs
live in [references/evaluation-and-venues.md](references/evaluation-and-venues.md).

### Step 6: Escalate to batch, sweep, or orchestrate only when scale is the real problem

- `batch` / `plot-batch` — many items from one manifest; optional `composite` stitches panels into one labeled figure
- `sweep` — the same figure across a parameter grid, ranked by a quality proxy score
- `orchestrate` — parse a full paper, plan multiple method figures + data plots, emit a `figure_package.json` + `figures.tex` bundle

For one or two figures, single-shot `generate`/`plot` stays simpler and cheaper.

### Step 7: Expose it to agents only when a script is not the point

Use the MCP server (11 tools: `generate_diagram`, `generate_plot`, `continue_run`, `evaluate_diagram`,
`orchestrate_figures`, `batch_diagrams`, `batch_plots`, `download_references`, …) or the bundled Claude
Code skills (`/generate-diagram`, `/generate-plot`, `/evaluate-diagram`) when the goal is agent/IDE
access rather than a bespoke run.

bash
bash scripts/run-mcp.sh   # stdio MCP server via uvx --from paperbanana[mcp]


## Examples

### Example 1: The user has a CSV and wants a chart
Use `plot` (or `plot-batch`) — it renders matplotlib from a VLM and needs no image-gen key, so it is the cheapest path.

### Example 2: The user has one method paragraph and wants a diagram
Use `generate` with a clear `--caption`; add `--optimize`/`--auto` only if the first pass underdelivers.

### Example 3: The user already has a figure that is "almost right"
Use `polish` (guided edit) or `evaluate` (judge), not a fresh `generate` run.

### Example 4: The user wants every figure in a paper regenerated
Use `orchestrate` on the paper source; inspect `orchestration_plan.json` with `--dry-run` before spending credits.

### Example 5: The user wants an agent to make figures on demand
Expose the MCP server or the Claude Code skills instead of hand-writing a one-off script.

### Example 6: The figure is a trivial two-bar chart or exact vector art
Route out to plain matplotlib, TikZ, or a vector editor — a multi-agent generative run is overkill or the wrong tool.

## Best practices

1. Start with the smallest mode (`plot` < `generate` < `batch`/`sweep`/`orchestrate`) and escalate only on evidence.
2. Prefer `plot` for data — it skips the image-gen provider entirely and costs less.
3. Fix existing figures with `polish`/`evaluate` before paying for a full regeneration.
4. Treat `--optimize`, `--auto`, `--iterations`, and `--num-candidates` as cost dials — raise them only when a plain run falls short.
5. Pick the cheapest provider that meets quality (Gemini/Atlas VLMs are low cost); the pipeline is provider-agnostic.
6. Use venue style packs (`neurips`, `icml`, `acl`, `ieee`, or a custom pack) instead of hand-tuning aesthetics per run.
7. Judge with the VLM-as-Judge `evaluate` command before claiming a figure is publication-ready.
8. Route out honestly to matplotlib/TikZ/vector editors or a human designer when generative figures are the wrong tool.

## References

- [references/intake-and-route-outs.md](references/intake-and-route-outs.md)
- [references/pipeline-and-agents.md](references/pipeline-and-agents.md)
- [references/modes-and-cli.md](references/modes-and-cli.md)
- [references/providers-and-config.md](references/providers-and-config.md)
- [references/evaluation-and-venues.md](references/evaluation-and-venues.md)
- [scripts/install.sh](scripts/install.sh)
- [scripts/run.sh](scripts/run.sh)
- [scripts/run-mcp.sh](scripts/run-mcp.sh)
- [PaperBanana GitHub Repository](https://github.com/llmsresearch/paperbanana)
- [PaperBanana paper (arXiv:2601.23265)](https://arxiv.org/abs/2601.23265)

© akillness · MIT · akillness/jeo-skills

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

Все скиллы по теме «Наука и исследования» →
PaperBanana-CN mituan-ai MCP-сервер PaperBanana-CN собирает методологические схемы по описанию исследования и статистические графики из CSV или JSON, а потом проверяет качество результата. CX Codex +1 ★ 83звёзд репо matplotlib K-Dense-AI Скилл для построения и тонкой настройки научных графиков на Matplotlib: от отдельных осей до многопанельных фигур и экспорта в PNG, PDF и SVG. CX Codex +1 2 500установок figure-generation lingzhi227 Скилл figure-generation создаёт научные графики для статей через трёхэтапный пайплайн с проверкой кода и визуала. Пригодится при оформлении публикаций в LaTeX. CX Codex +1 2 300установок networkx K-Dense-AI Строит, анализирует и визуализирует графы через NetworkX 3.7 на Python. CX Codex +1 2 200установок mathmodel-figure-templates jihe520 Скилл mathmodel-figure-templates запускает готовые скрипты на Python и matplotlib для построения научных графиков в песочнице. Помогает собрать диаграммы Тейлора, матрицы корреляций и кривые ROC. CX Codex +1 1 700установок analytics-data-analysis Mindrally Скилл analytics-data-analysis для Claude Code задаёт правила анализа данных на Python с pandas, matplotlib, seaborn и Jupyter. Включается при разведочном анализе, очистке датасетов и построении статистических графиков. CX Codex +1 1 200установок

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

Весь набор →
okf Скилл okf пишет и проверяет бандлы Google Open Knowledge Format v0.1: папка Markdown-файлов с YAML-фронтматтером, которую прочитает любой агент. CX Codex +1 127установок agentic-skills Скилл agentic-skills ведёт задачу через шесть фаз, от спеки до релиза, и не даёт писать код раньше зафиксированных требований. CX Codex +1 125установок x-twitter-scraper Скилл x-twitter-scraper получает данные из X через Xquik: ищет посты, находит пользователей, скачивает медиа и выполняет подтверждённые действия. CX Codex +1 124установок deep-research Скилл deep-research для Claude Code превращает тему в расширяемый план исследования, запускает параллельных агентов по пунктам и собирает markdown-отчёт. Сравнивает набор объектов по общим полям. CX Codex +1 120установок webtoon-harness Скилл webtoon-harness ведёт выпуск вебтуна от изучения трендов до вертикального просмотрщика. Он пригодится, если нужно подготовить сценарий и отрисовать панели в одном процессе. CX Codex +1 115установок opencut Помогает разбираться с репозиторием видеоредактора OpenCut. Он включается при настройке проекта, изучении Rust/WASM-ядра или подготовке изменений. CX Codex +1 114установок devup-ui Внедряет zero-runtime CSS-in-JS библиотеку Devup UI в проекты на React, настраивает плагины сборщика и переносит стили без клиентского рантайма. CX Codex +1 111установок gbro-collage-broll Скилл gbro-collage-broll для Claude Code превращает короткую реплику или абстрактную мысль в видео с бумажным коллажем и полутоновым эффектом. Сначала он предлагает метафору и готовит кадр, а после подтверждения генерирует ролик. CX Codex +1 100установок

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

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