paper-explain-figures

Interprets academic paper figures by combining visual analysis and source code retrieval into Markdown reports.

2.7k|251|Updated Feb 12, 2024
One-click install
npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill paper-explain-figures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-explain-figures
Source: https://github.com/huangwb8/ChineseResearchLaTeX/tree/main/skills/paper-explain-figures
Command: npx skills add https://github.com/huangwb8/ChineseResearchLaTeX --skill paper-explain-figures

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Reading complex academic figures is time-consuming, especially when the underlying plotting code and context are unclear. This Skill interprets one or more paper figures by combining visual understanding, automatic retrieval of the source code that generated each figure, and optional user notes, producing a structured Markdown report that teaches you how to read each figure.

Core Features & Use Cases

  • Multi-source figure interpretation: Converts figures to JPG for visual analysis, automatically searches nearby directories for the generating source code (.R, .py, .ipynb, .tex, etc.), and merges both into a structured report with sections for core meaning, variable definitions, key takeaways, explanation, and scientific value.
  • Process-isolated parallel analysis: Runs each figure through an isolated codex exec or claude -p subprocess with a configurable concurrency limit (default 3), keeping all intermediate files inside a dedicated hidden workspace directory.
  • Read-only safety guarantee: Never modifies your figures or source code; runtime directories (HOME, TMP, XDG) are redirected into the task workspace and leaks are audited and cleaned automatically.
  • Use Case: You have three result plots from a bioinformatics experiment. Point the Skill at their absolute paths, add a note about what trends you care about, and receive a single paper-explain-figures_report.md explaining each figure's axes, variables, and scientific implications.

Quick Start

Ask the AI to use the paper-explain-figures skill to interpret your figure by providing its absolute file path, optionally with a note describing what aspects of the figure you care about.

Frequently Asked Questions about paper-explain-figures

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I interpret academic paper figures with AI?

Provide the absolute path of one or more figure files to the paper-explain-figures skill. It converts each figure to JPG for visual analysis, searches nearby directories for the generating source code, and outputs a structured Markdown report explaining each figure's meaning, variables, and scientific value.

How to analyze multiple research figures in parallel?

Pass multiple --fig arguments with absolute paths and add the --parallel flag with --max-parallel set to 3 or lower. Each figure is interpreted in an isolated codex exec or claude -p subprocess, and results are merged into a single report.

What figure formats does paper-explain-figures support?

Common formats including PNG, JPG, PDF, and TIFF are supported. Figures are converted to JPG using sips or ImageMagick for visual understanding; if conversion fails, the original image is kept and the report notes the failure.

Why does source code retrieval fail for my figure?

Retrieval fails when the code file is outside the search range (figure directory plus two parent levels), when the code never mentions the figure filename, or when the filename stem is shorter than 8 characters. Use --code-path to explicitly specify the source file.

Can this skill modify my figures or plotting code?

No. The skill is strictly read-only for user figures and source code. All intermediate files, logs, and runtime directories are confined to a hidden .bensz-api task workspace in the current directory, and any leaked files are automatically cleaned up.