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

paper-figure-guide — скилл для Claude Code: PDF-гид по рисункам

Скилл paper-figure-guide для Claude Code, который разбирает рисунки научной статьи и собирает по ним цветной PDF-гид. Запускается по просьбе объяснить или разобрать рисунки статьи.

MIT ★ 88 обновлён 2026-11-14

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

Что делает paper-figure-guide

Скилл превращает рисунки научной статьи в цветной PDF-гид с пояснениями прямо на изображениях. Он разбирает каждый рисунок и его панели, связывает их с основным тезисом статьи, добавляет блоки «Как читать» и «Что показывает», а также вспомогательные иллюстрации для нужных понятий.

Исходником может быть PDF или LaTeX. Данные для графиков берутся из исходных файлов, векторных объектов PDF или растровых изображений; извлечённые значения сверяются с числами в статье. Для сборки используются LaTeX и pdflatex, который запускается дважды. Если пакетов TeX не хватает, инструкция приводит команду установки для apt-get; для извлечения данных из векторных графиков применяется PyMuPDF.

Перед отправкой PDF страницы рендерятся и проверяются на пересечения подписей и нечитаемые элементы. Числа в гиде должны совпадать со статьёй, а собственные примеры помечаются как иллюстрации. Для доставки файла используется SendUserFile.

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

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

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

  • Разбери рисунки этой статьи и собери цветной PDF-гид.
  • Объясни графики в paper.pdf: подпиши ключевые участки и значения.
  • Подготовь гид по рисункам из LaTeX-исходников этой статьи.

Как установить paper-figure-guide

1Через Skills CLI (Vercel)

npx skills add mkaremm80/My-Skills-on-Claude --skill paper-figure-guide -a claude-code

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

~/.claude/skills/paper-figure-guide/SKILL.md

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

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

Вопросы о paper-figure-guide

Как установить paper-figure-guide в Claude Code?

Выполни npx skills add mkaremm80/My-Skills-on-Claude --skill paper-figure-guide -a claude-code. Файл скилла находится по пути ~/.claude/skills/paper-figure-guide/SKILL.md.

Что делает paper-figure-guide?

Он поясняет рисунки научной статьи и собирает их в цветной PDF-гид. В документ входят аннотации, разбор чтения графиков и вспомогательные иллюстрации.

Что нужно для работы paper-figure-guide?

Нужна статья в PDF или LaTeX и pdflatex для сборки документа. Для извлечения данных из векторных графиков используется PyMuPDF; инструкция также перечисляет пакеты LaTeX и команду их установки через apt-get.

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

SKILL.md · MIT
---
name: "paper-figure-guide"
description: "Explain every figure of a research paper in a colored PDF guide with annotated figures (callouts, arrows, shaded regions) and helper drawings. Use when asked to explain or understand a paper's figures."
---

# Paper Figure Guide

Turn the figures of any research paper (PDF or LaTeX) into a colored, easy-to-read PDF guide. Every figure is shown again with explanations drawn on it (numbered red circles, arrows, notes, shaded regions), followed by "How to read it" and "What it tells us" boxes. Add one or two helper drawings for the key ideas the figures assume.

Writing style: English, short sentences, simple words (B2 level), professional. Numbers must come from the paper, never invented. If you illustrate with your own example (e.g., one simulated realization), say so clearly next to it.

## Step 1 - Read the paper and plan
1. Read the whole paper first. List every figure (and panel), its caption, the section that discusses it, and the numbers the text quotes about it.
2. Find the paper's main message and write the story chain: which figure shows HOW the system works, which shows WHEN/WHERE the method helps, which shows HOW MUCH it gains. This chain goes on the cover.
3. Decide which concepts a reader needs to understand the figures (e.g., a dimension, a threshold, a mechanism). Each one becomes a helper drawing.

## Step 2 - Get the figure content
Use the best source available, in this order:
1. **LaTeX source / TikZ / data files** given by the user: reuse them directly.
2. **Vector plots inside the PDF** (MATLAB/matplotlib exports): extract the real data with PyMuPDF (`pip install --break-system-packages pymupdf`; `import pymupdf as fitz`).
   - `page.get_drawings()` gives paths with color, width and items. A curve is usually one path with many `'l'` (line) items; markers are small closed paths; error bars are short vertical lines plus caps.
   - Group by stroke color to separate series; split panels by x-range.
   - Calibrate axes from tick labels: take text spans from `page.get_text('dict')`, keep numeric spans of the tick font size inside the axis region, and fit pixel-to-value with `np.polyfit`. Check the calibration against a number quoted in the text or a printed value (e.g., heat-map cell labels can be read directly as text spans).
   - If an x-calibration looks wrong (picked up nearby labels), use the known discrete x values (e.g., budgets 3..8) by order.
3. **Raster images** (`pdfimages -list`, then `pdfimages -png`): keep the image and draw annotations on top (TikZ overlay or matplotlib `imshow` + `annotate`). Read values from the figure only when the text confirms them.
4. Always verify extracted data with at least one number from the text (e.g., recompute a reported percentage).

## Step 3 - Make the annotated figures
- **Block diagrams / system figures:** if TikZ source exists, add numbered badges at node anchors, e.g.
  `\tikzset{badge/.style={circle, fill=red!75!black, text=white, font=\footnotesize\bfseries, inner sep=1.2pt, minimum size=4.2mm}}` then `\node[badge] at (tx.north west) {1};`. Compile as a `standalone` PDF. For raster diagrams, overlay badges with TikZ `\begin{scope}[x={(img.south east)},y={(img.north west)}]`. Explain each number in a table (No. | Part | What it means).
- **Plots:** redraw with matplotlib from the extracted data at readable size (about 6.8 x 4.2 in, fonts 10-11 pt, `font.family='STIXGeneral'`, `mathtext.fontset='stix'`, `pdf.fonttype=42`). Then add:
  - `ax.annotate(text, xy=point, xytext=box_position, arrowprops=dict(arrowstyle='-|>', color='#C0392B', lw=1.4), bbox=dict(boxstyle='round,pad=0.3', fc='#FFF8E1', ec='#E09F3E'))` for notes.
  - `ax.fill_between` (green for gain, red for loss) and `ax.axvspan` for regimes.
  - boundary lines (e.g., a red staircase on a heat map), reference lines, and the key numbers (max gain, crossing points).
  - Put long explanations in the title or in the guide text instead of inside the plot.
- **Helper drawings:** small plots that make the hidden concept visible (e.g., eigenvalue bars + cumulative energy to show an effective dimension; one example realization showing where probes or samples go). Label them "Helper drawing A/B" and say what is an illustration.
- Render every figure to PNG (`pdftoppm -r 70`) and look at it. Fix any label that overlaps data, colorbars, legends or axis labels before moving on.

## Step 4 - Build the colored PDF (LaTeX)
Use `article`, A4, `helvet` sans font, `xcolor[table]`, `tcolorbox[most]`, `tikz`, `booktabs`, `tabularx`, `enumitem`, `titlesec`, `fancyhdr`, `float`, `caption`, `needspace`, `bm`. Define colors navy #1B3A5C, teal #00798C, rosered #D1495B, amber #E09F3E, leaf #2E8B57 and boxes: `verdict` (teal), `goodbox` (green, "What it tells us"), `notebox` (amber), `critical` (red), `stepbox` (navy, "How to read it"). Define `\newcolumntype{P}[1]{>{\raggedright\arraybackslash}p{#1}}`. Pass box titles as `title={#1}` (an `=` inside a title breaks otherwise).

Structure:
1. **Cover banner** (navy TikZ band): "How to Read Every Figure in the Paper", paper title, date.
2. **Story box:** a 3-box TikZ chain (Fig. X - HOW -> Fig. Y - WHEN -> Fig. Z - HOW MUCH) and the main message in 2-3 sentences.
3. **Words used in this guide:** table of symbols and terms in simple words.
4. **One section per figure** (start big sections with `\clearpage` or `\Needspace{14\baselineskip}` so headings are not left alone at a page bottom). For each panel: annotated figure, "How to read it" (numbered steps: axes, units, colors, what each marker/line is), a small table of the key values when useful, and "What it tells us" (trends, crossing points, best/worst cases, why).
5. **Helper drawings** placed right after the figure that needs them.
6. **Summary table:** one sentence of meaning per figure.
7. A gray footnote stating the data source (exact paper data vs. illustrative example).

Compile twice with `pdflatex -interaction=nonstopmode`. If TeX packages are missing: `apt-get update && apt-get install -y texlive-latex-extra texlive-fonts-extra texlive-publishers texlive-science`. If `newtxmath` fails with `binhex.tex not found`, use `mathptmx` instead.

## Step 5 - Check before sending
- Render all pages (`pdftoppm -r 50`) into a montage and look at every page: no overlaps, no orphan headings, figures readable, badges not covering text.
- Every number in the guide matches the paper (or is clearly labeled as an illustration).
- Deliver the PDF with SendUserFile and give a short summary of what each figure section contains.
- If the user asks for changes, keep the same file name with a new version number (v2, v3, ...).

© mkaremm80 · MIT · mkaremm80/My-Skills-on-Claude

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

Все скиллы по теме «Наука и исследования» →
paper-figure wanshuiyin Скилл paper-figure в Claude Code пишет код графиков по результатам экспериментов и собирает таблицы для научной статьи. Генерирует кривые обучения, сравнения методов, тепловые карты и LaTeX-таблицы из готовых данных. CX Codex +1 687установок figure-designer HKUSTDial Скилл figure-designer помогает выбрать тип, компоновку и инструмент для трёх главных рисунков статьи, а потом проверяет их по набору правил. CX Codex +1 919установок paper-compilation lingzhi227 Скилл paper-compilation для Claude Code собирает LaTeX-статью в PDF, ловит ошибки компиляции и проверяет ссылки с цитатами. Читает лог и устраняет ошибки без ручного разбора. CX Codex +1 1 700установок paper-writing wanshuiyin Скилл paper-writing автоматизирует подготовку научной статьи от плана и графиков до компиляции LaTeX в готовый PDF. Помогает оформить публикацию под требования выбранной конференции. CX Codex +1 619установок paper-audit bahayonghang Скилл paper-audit проверяет академические статьи перед рецензированием или подачей, находит блокеры и формирует план правок для .tex, .typ и .pdf. CX Codex +1 3 600установок paper-2-web davila7 Скилл paper-2-web для Claude Code берёт академическую статью в формате LaTeX или PDF и собирает из неё интерактивный сайт, конференц-постер или видеопрезентацию. Запускается через pipeline Paper2All с ключом OPENAI_API_KEY. CX Codex +1 133установок

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

paper-explainer-video Скилл paper-explainer-video для Claude Code превращает раздел или результат научной статьи в анимированное видео с графиками. Агент подключает его по просьбе сделать объясняющее видео по исследованию. CX Codex +1 ★ 88звёзд репо paper-equation-guide Скилл paper-equation-guide для Claude Code превращает математику научной статьи в цветной PDF-гид. Подключается, когда нужно объяснить формулы статьи. CX Codex +1 ★ 88звёзд репо lecture-survey-gap-finder Скилл lecture-survey-gap-finder для Claude Code собирает обзор научной литературы в PDF. Он включается, когда просят найти исследования по теме, пробелы в знаниях или идеи статей для журнала Q1. CX Codex +1 ★ 88звёзд репо paper-from-zero-guide Скилл paper-from-zero-guide для Claude Code превращает научную статью или технический документ в цветной PDF-гид. Запускается, когда нужно разобрать сложный текст с основ. CX Codex +1 ★ 88звёзд репо paper-comic Скилл paper-comic для Claude Code превращает научную статью в комиксный PDF с персонажами и речевыми облаками. Включается по просьбе сделать из статьи визуальное объяснение. CX Codex +1 ★ 88звёзд репо

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

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