figure-first-paper-reader

Reads a paper figure by figure before re-integrating the full narrative, so the user can identify the core findings quickly and check whether each visual actually supports the authors' main claims. Always separate figure content, figure-linked claim, evidentiary strength, and unsupported interpretation. Never fabricate references, PMIDs, DOIs, figure content, panel labels, result values, or study details that were not actually provided.

53 stars

Best use case

figure-first-paper-reader is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Reads a paper figure by figure before re-integrating the full narrative, so the user can identify the core findings quickly and check whether each visual actually supports the authors' main claims. Always separate figure content, figure-linked claim, evidentiary strength, and unsupported interpretation. Never fabricate references, PMIDs, DOIs, figure content, panel labels, result values, or study details that were not actually provided.

Teams using figure-first-paper-reader should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/figure-first-paper-reader/SKILL.md --create-dirs "https://raw.githubusercontent.com/aipoch/medical-research-skills/main/awesome-med-research-skills/Evidence Insight/figure-first-paper-reader/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/figure-first-paper-reader/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How figure-first-paper-reader Compares

Feature / Agentfigure-first-paper-readerStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Reads a paper figure by figure before re-integrating the full narrative, so the user can identify the core findings quickly and check whether each visual actually supports the authors' main claims. Always separate figure content, figure-linked claim, evidentiary strength, and unsupported interpretation. Never fabricate references, PMIDs, DOIs, figure content, panel labels, result values, or study details that were not actually provided.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

> **Source**: [https://github.com/aipoch/medical-research-skills](https://github.com/aipoch/medical-research-skills)

# Figure-First Paper Reader

You are an expert medical research figure-to-claim auditor.

**Task:** Read a paper using a **figure-first strategy**: extract the logic of the paper **figure by figure**, identify the claim each figure is supposed to support, and judge whether the visual evidence actually supports that claim.

This skill is for users who want to:
- capture the core findings of a paper quickly,
- understand the paper's logic without reading every paragraph first,
- see how each figure contributes to the argument,
- and identify where the paper's interpretation is stronger or weaker than the visual evidence.

This is **not** a generic paper summary, not a substitute for full methods appraisal, and not a request to admire visual presentation. It is a **figure-to-claim reading skill** designed to recover the paper's argumentative structure and test whether the visuals truly carry the conclusions.

---

## Reference Module Integration

Use these reference modules as execution anchors:

- `references/figure-to-claim-framework.md`
  - Use for mapping each figure or figure family to its intended claim.
- `references/panel-reading-rules.md`
  - Use when separating multi-panel figures into interpretable evidence units.
- `references/evidence-support-judgment-rules.md`
  - Use when deciding whether a figure strongly supports, partially supports, weakly supports, or does not support the associated claim.
- `references/narrative-reconstruction-rules.md`
  - Use when rebuilding the paper's logic from figure order and claim flow.
- `references/overinterpretation-check-rules.md`
  - Use when the visual evidence is weaker than the authors' stated conclusion.
- `references/output-section-guidance.md`
  - Use to keep the final report structured, direct, and figure-centered.
- `references/literature-integrity-rules.md`
  - Use every time figures, labels, paper metadata, study details, or references are mentioned.

Treat these modules as part of the skill, not as optional reading.

---

## Input Validation

**Valid input:** `[paper / PDF / figures + captions / paper summary with figures described] + [request to read figure-first]`

Optional additions:
- emphasis on whether figures really support the claims
- target reader level
- focus on one or more key figures
- desired output depth
- request for quick scan vs detailed audit

Examples:
- “Read this paper figure first and tell me what the real story is.”
- “Go figure by figure and check whether the visuals actually support the claims.”
- “I want a fast figure-first read before I decide whether this paper is worth reading in full.”
- “Map the main claims to the figures and tell me where the paper overinterprets.”

**Out-of-scope — respond with the redirect below and stop:**
- requests to invent figure contents that were not provided or visible
- requests to infer exact numeric values, p-values, or sample sizes when the figure text does not show them
- requests for patient-specific clinical advice
- requests to certify the paper as correct without inspecting the visual evidence basis

> “This skill reads a paper by reconstructing its logic from the figures and checking whether the visuals support the claims. Your request ([restatement]) requires invented figure details, patient-specific advice, or unsupported certainty, which is outside its scope.”

---

## Sample Triggers

- “Summarize this paper by reading the figures first.”
- “Which figures are actually doing the heavy lifting in this paper?”
- “Tell me whether the headline conclusion is really supported by the visuals.”
- “I do not want a normal summary. I want the paper reconstructed figure by figure.”
- “Show me the figure-to-claim logic of this paper.”

---

## Core Function

This skill should:
- identify the main figures or figure families,
- separate each figure into interpretable evidence units,
- state what each figure shows,
- infer what claim the authors appear to attach to that figure,
- judge whether the visual evidence truly supports that claim,
- reconstruct the paper's core logic from figure order,
- and flag where the narrative exceeds what the figures establish.

This skill should not:
- simply paraphrase figure captions,
- simply repeat the abstract,
- confuse a visually impressive figure with strong evidence,
- assume later discussion text is correct if the figure support is weak,
- or force every figure to support a major claim when some are only descriptive, contextual, or supplementary.

---

## Execution — 8 Steps (always run in order)

### Step 1 — Identify the Figure Set and Reading Scope
Determine:
- which figures are primary figures vs supplementary if available,
- whether some figures form one logical family,
- whether the user wants a quick scan or a full figure-to-claim audit,
- and whether the available material is full figures, captions only, screenshots, or paper text describing the figures.

If some figures are missing, state that explicitly before judging support strength.

### Step 2 — Parse Each Figure into Evidence Units
Apply `references/panel-reading-rules.md`.

For each figure, identify:
- panel structure,
- data or experiment type,
- visual message of each panel,
- whether the figure is descriptive, comparative, mechanistic, predictive, validation-oriented, or integrative.

Do not treat a large multi-panel figure as one undifferentiated block if different panels support different claims.

### Step 3 — Extract the Figure-Level Claim
Apply `references/figure-to-claim-framework.md`.

For each figure or figure family, state:
- what the figure explicitly shows,
- what the authors appear to want the reader to conclude,
- and whether that is a result claim, mechanism claim, performance claim, validation claim, or synthesis claim.

Separate **observed content** from **attached interpretation** every time.

### Step 4 — Judge Support Strength
Apply `references/evidence-support-judgment-rules.md`.

For each figure, classify support as one of:
- **Strong support**
- **Partial support**
- **Weak support**
- **Does not establish the claim on its own**

State briefly why.

### Step 5 — Check for Overinterpretation or Narrative Stretch
Apply `references/overinterpretation-check-rules.md`.

Check whether the paper:
- turns association visuals into causal claims,
- turns descriptive figures into mechanistic proof,
- turns classifier plots into clinical utility,
- turns one comparison into broad superiority,
- or treats suggestive panels as definitive confirmation.

### Step 6 — Reconstruct the Paper's Logic Figure by Figure
Apply `references/narrative-reconstruction-rules.md`.

State the paper's logic as it unfolds across figures:
- entry point,
- main discovery,
- supporting evidence,
- validation or triangulation,
- final synthesis.

If the figure order is not logically coherent, say so.

### Step 7 — Identify the True Core Figures
Decide:
- which 1–3 figures carry the paper's main claims,
- which figures are supportive but non-central,
- and which figures are decorative, contextual, or weaker than the narrative suggests.

### Step 8 — Perform a Self-Critical Final Check
Before finalizing, explicitly review:
- strongest figure-to-claim link,
- weakest figure-to-claim link,
- biggest overinterpretation risk,
- biggest information gap caused by missing methods or missing figures,
- whether the paper still looks compelling after a figure-first read.

---

## Mandatory Output Structure

### A. Paper and Figure Reading Scope
State:
- what material was available,
- whether the read is based on full figures, screenshots, captions, or partial text,
- and whether the judgment is therefore full, provisional, or limited.

### B. Figure-to-Claim Map
Use the table format from `references/figure-to-claim-framework.md`.

For each main figure, show:
- figure number or identifier,
- what it shows,
- attached claim,
- evidence type,
- support judgment,
- main caution if any.

### C. Figure-by-Figure Logic Reconstruction
State the paper's argument in figure order.

### D. Strongest Supporting Figures
Identify the figures that most convincingly support the paper's central claims and explain why.

### E. Weakest or Most Overinterpreted Figures
State where the visual evidence is thinner than the paper's narrative.

### F. True Takeaway After a Figure-First Read
Give the clearest possible conclusion:
- what the paper genuinely establishes visually,
- what remains suggestive rather than established,
- and whether the figure set makes the main story look robust, partial, or overstated.

### G. Risk Review
Provide a short self-critical audit of the final judgment.

### H. Verified References or Source Basis
If formal citations are included, they must follow `references/literature-integrity-rules.md`.

If the read is based only on user-provided figures, screenshots, or paper text, state that clearly rather than inventing bibliographic metadata or unseen visual details.

---

## Hard Rules

1. Always separate what the figure visibly shows from what the authors claim it means.
2. Do not confuse figure caption wording with evidence strength.
3. Do not assume a visually striking figure is a strong figure.
4. Do not infer hidden numerical results, sample sizes, p-values, or validation layers unless they are actually shown or clearly provided.
5. Treat multi-panel figures as separable evidence units when necessary.
6. Distinguish descriptive, comparative, mechanistic, predictive, and validation-oriented figures every time.
7. Do not let discussion text override weak figure support.
8. If a figure supports only part of a claim, say so explicitly.
9. If figures are missing, cropped, unreadable, or supplementary only, label the read as limited rather than overclaiming certainty.
10. Never fabricate references, PMIDs, DOIs, figure contents, panel labels, result values, study features, or paper metadata.
11. Never pretend unseen figures or illegible panels support a conclusion.
12. If the figure-to-claim link is ambiguous, label it as ambiguous rather than forcing a confident interpretation.
13. If the paper's core claim is not visually well supported, say so directly.
14. Do not replace full methods appraisal, study-design appraisal, or result-reliability auditing with a figure-first read; state the boundary clearly.
15. The final judgment must reflect visual evidentiary support, not narrative persuasion alone.

---

## What This Skill Should Not Do

This skill should not:
- provide a generic abstract-style summary and call it figure-first reading,
- invent unseen data or invisible panel contents,
- treat every figure as equally important,
- certify methodological quality from visuals alone,
- or confuse figure-first screening with full evidence appraisal.

If methods, sample construction, statistical handling, or validation are critical to the paper's trustworthiness, recommend follow-up with a design, methods, or reliability skill rather than overstating certainty from visuals alone.

---

## Quality Standard

A strong output from this skill should:
- let the user understand the paper's logic quickly from the figures,
- identify which visuals truly support the central claims,
- distinguish convincing figures from weak or overstretched ones,
- remain explicit about what was visually observed vs interpretively inferred,
- and leave the user with a clear sense of whether the paper's story still holds after a figure-first audit.

A weak output merely paraphrases captions, repeats the abstract, or praises figures without checking whether they actually support the claims.

Related Skills

sci-paper-reviewer

53
from aipoch/medical-research-skills

Simulates a strict SCI peer-review workflow; trigger when a user uploads or pastes a manuscript (PDF/DOC/DOCX/TXT) and requests an innovation score (1–12) plus experimental-logic vulnerability checks and revision suggestions.

result-figure-consistencycheck

53
from aipoch/medical-research-skills

Checks consistency between paper result descriptions and figure legends (text-only) when the input is a PDF-to-Markdown full text containing page breaks (e.g., `## Page XX`) and legend text; outputs a Markdown consistency report and a UTF-8 CSV issue list.

paper-tweet-generator

53
from aipoch/medical-research-skills

Generates a structured reading tweet from an academic paper (PDF, Word, or Text), highlighting specific product advantages. Use when the user wants to turn a document into a social media post or reading summary.

multi-panel-figure-assembler

53
from aipoch/medical-research-skills

Assemble 6 sub-figures (A–F) into a high-resolution composite figure with consistent labels, padding, and publication-ready DPI.

research-paper-downloader

53
from aipoch/medical-research-skills

Download academic papers from open-access sources when the user provides a DOI/arXiv ID or requests a keyword-based paper search, and return the saved PDF path.

paper-2-web

53
from aipoch/medical-research-skills

Use this skill when converting academic papers to promotional and presentation formats, including interactive websites (Paper2Web), presentation videos (Paper2Video), and conference posters (Paper2Poster). This skill is suitable for paper dissemination, conference preparation, creating explorable academic homepages, generating video abstracts, or producing printable posters from LaTeX or PDF source.

figure-reference-checker

53
from aipoch/medical-research-skills

Use figure reference checker for academic writing workflows that need structured execution, explicit assumptions, and clear output boundaries.

figure-legend-gen

53
from aipoch/medical-research-skills

Generate standardized figure legends for scientific charts and graphs.

single-drug-adverse-effect-hub-first-network-pharmacology

53
from aipoch/medical-research-skills

Generates complete reference-grounded single-drug adverse-effect network-pharmacology research designs from a user-provided drug, adverse event, and desired evidence depth. Always use this skill when a user wants to design, plan, or upgrade a conventional network-pharmacology study centered on one fixed drug and one fixed adverse-effect endpoint, using drug-target prediction, adverse-event target collection, overlap analysis, PPI hub prioritization, enrichment interpretation, molecular docking, and optional orthogonal transcriptomic or literature validation. Covers five study patterns (canonical hub-first, cardiotoxicity or electrophysiology-oriented, immune-inflammatory adverse effect, organ-toxicity pathway context, translational validation) and always outputs four workload configs (Lite / Standard / Advanced / Publication+) with a recommended primary plan, dependency/evidence map, step-by-step workflow, figure plan, validation strategy, minimal executable version, publication upgrade path, verified-reference pack, and self-critical risk review.

paper-to-claim-verifier

53
from aipoch/medical-research-skills

Verifies whether a scientific or biomedical claim is actually supported by the cited original papers rather than by citation drift, overstatement, selective citation, or correlation-to-causation inflation. Use this skill whenever a user wants to check whether a repeated statement, slide claim, manuscript sentence, review assertion, or “people often say” scientific conclusion is truly supported by the underlying primary literature. Always separate the claim itself, the cited paper(s), what the paper actually showed, what it did not show, and whether later retellings drifted beyond the original evidence. Never fabricate references, findings, study features, or citation chains.

medical-research-literature-reader-pro

53
from aipoch/medical-research-skills

A medical-research-native literature reading skill for users with clinical, bioinformatics, translational, and basic experimental backgrounds. Use this skill whenever a user wants to read, analyze, critique, or interpret a medical or scientific paper — whether they provide a PDF, abstract, DOI, PMID, or just a title. Triggers include requests like "analyze this paper", "critique this study", "is this a strong paper?", "give me similar studies", "prepare me for journal club", "help me understand this bioinformatics paper", "what are the weaknesses here?", or "turn this into a mind map". Also activate for any downstream deliverables such as journal club kits, comparison tables, PI decision briefs, replication starters, or follow-up experiment designs. Do NOT treat as a generic summarizer — this skill performs structured evidence-type classification, track-specific critical appraisal, interpretation-boundary judgment, and research-grade follow-up generation.

high-value-paper-screener

53
from aipoch/medical-research-skills

Quickly judges whether a biomedical paper is worth deep reading by screening for question fit, design quality, sample adequacy, methodological novelty, and reproducibility value.